# sportradar/mbssdknet architecture

> Architecture diagram of the GitHub repository sportradar/mbssdknet, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sportradar/mbssdknet
- Repository: https://github.com/sportradar/mbssdknet

## Overview

Mbs SDK is a .NET client for the MBS web interface. An integrator configures and connects an MbsSdk, then invokes a domain protocol with a typed request and receives a matching response. The runtime wraps requests in correlated protocol envelopes, serializes them over a WebSocket, and dispatches replies to waiting operations. Separate protocol families cover tickets, accounts, balances, gaming, and campaigns. Relationships among unsampled protocol implementations are limited to those named in the README or source index; the graph does not imply a database or inspect unshown internals.

Main entry points: [`src/Sportradar.Mbs.Sdk/MbsSdk.cs`](https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/MbsSdk.cs) (SDK lifecycle), [`src/Sportradar.Mbs.Sdk/Internal/Protocol/ProtocolEngine.Request.cs`](https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Internal/Protocol/ProtocolEngine.Request.cs) (Request handling), [`src/Sportradar.Mbs.Sdk/Internal/Protocol/ProtocolEngine.cs`](https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Internal/Protocol/ProtocolEngine.cs) (Request engine), [`src/Sportradar.Mbs.Sdk/Internal/Protocol/ProtocolEngine.Dispatcher.cs`](https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Internal/Protocol/ProtocolEngine.Dispatcher.cs) (Reply dispatcher)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["SDK API"]
  node_mbs["SDK lifecycle<br/>[MbsSdk.cs]"]
  node_config["SDK configuration<br/>[MbsSdkConfig.cs]"]
  node_interfaces["Protocol interfaces<br/>[Protocol]"]
end

subgraph group_domains["Domain Protocols"]
  node_ticket["Ticket operations<br/>[TicketProtocol.cs]"]
  node_account["Account operations<br/>[AccountProtocol.cs]"]
  node_balance["Balance operations<br/>[BalanceProtocol.cs]"]
  node_gaming["Gaming operations<br/>[GamingProtocol.cs]"]
  node_campaign["Campaign operations"]
end

subgraph group_runtime["Protocol Runtime"]
  node_engine["Request engine<br/>[ProtocolEngine.cs]"]
  node_requestflow["Request handling"]
  node_responseflow["Response correlation"]
  node_dispatcher["Reply dispatcher"]
  node_json["JSON codec<br/>[Json.cs]"]
end

subgraph group_transport["WebSocket Transport"]
  node_connection["Connection provider"]
  node_websocket["WebSocket connection"]
  node_auth["Token provider<br/>[TokenProvider.cs]"]
end

subgraph group_messages["Message Models"]
  node_envelopes["Protocol envelopes<br/>[Request.cs]"]
  node_responseenvelope["Response envelope<br/>[Response.cs]"]
  node_requesttypes["Request types"]
  node_responsetypes["Response types"]
end

node_integrator(("Integrating app"))
node_mbsserver(("MBS server"))
node_authserver(("Auth server"))

node_integrator -->|"creates and connects"| node_mbs
node_integrator -->|"provides settings"| node_config
node_mbs -->|"uses"| node_config
node_mbs -->|"exposes protocols"| node_interfaces
node_mbs -->|"creates"| node_engine
node_mbs -->|"exposes"| node_ticket
node_mbs -->|"exposes"| node_account
node_mbs -->|"exposes"| node_balance
node_mbs -->|"exposes"| node_gaming
node_mbs -->|"exposes"| node_campaign
node_ticket -.->|"submits operations"| node_requestflow
node_account -.->|"submits operations"| node_requestflow
node_balance -.->|"submits operations"| node_requestflow
node_gaming -.->|"submits operations"| node_requestflow
node_campaign -.->|"submits operations"| node_requestflow
node_engine -->|"constructs"| node_connection
node_engine -->|"starts dispatchers"| node_dispatcher
node_requestflow -->|"builds"| node_envelopes
node_requestflow -->|"awaits reply"| node_responseflow
node_responseflow -->|"serializes content"| node_requesttypes
node_dispatcher -->|"dispatches decoded"| node_responseenvelope
node_dispatcher -->|"correlates reply"| node_responseflow
node_json -->|"serializes"| node_envelopes
node_json -->|"deserializes"| node_responseenvelope
node_envelopes -->|"contains"| node_requesttypes
node_responseenvelope -->|"contains"| node_responsetypes
node_connection -->|"uses"| node_websocket
node_websocket -->|"requests tokens"| node_auth
node_websocket -->|"connects to"| node_mbsserver
node_auth -.->|"authenticates with"| node_authserver

click node_mbs "https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/MbsSdk.cs"
click node_config "https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/MbsSdkConfig.cs"
click node_ticket "https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Internal/Protocol/TicketProtocol.cs"
click node_account "https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Internal/Protocol/AccountProtocol.cs"
click node_balance "https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Internal/Protocol/BalanceProtocol.cs"
click node_gaming "https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Internal/Protocol/GamingProtocol.cs"
click node_campaign "https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Internal/Protocol/CampaignProtocol.cs"
click node_interfaces "https://github.com/sportradar/mbssdknet/tree/main/src/Sportradar.Mbs.Sdk/Protocol"
click node_engine "https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Internal/Protocol/ProtocolEngine.cs"
click node_requestflow "https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Internal/Protocol/ProtocolEngine.Request.cs"
click node_responseflow "https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Internal/Protocol/ProtocolEngine.Response.cs"
click node_dispatcher "https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Internal/Protocol/ProtocolEngine.Dispatcher.cs"
click node_connection "https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Internal/Connection/ConnectionProvider.cs"
click node_websocket "https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Internal/Connection/WebSocketConnection.cs"
click node_auth "https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Internal/Connection/TokenProvider.cs"
click node_envelopes "https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Entities/Internal/Request.cs"
click node_responseenvelope "https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Entities/Internal/Response.cs"
click node_requesttypes "https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Entities/Request/ContentRequestBase.cs"
click node_responsetypes "https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Entities/Response/ContentResponseBase.cs"
click node_json "https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Internal/Utils/Json.cs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_mbs,node_config,node_interfaces toneBlue
class node_ticket,node_account,node_balance,node_gaming,node_campaign toneAmber
class node_engine,node_requestflow,node_responseflow,node_dispatcher,node_json,node_mbsserver,node_authserver toneMint
class node_connection,node_websocket,node_auth toneRose
class node_envelopes,node_responseenvelope,node_requesttypes,node_responsetypes,node_integrator toneIndigo
```

## Components

### SDK API

- [SDK lifecycle](https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/MbsSdk.cs): `src/Sportradar.Mbs.Sdk/MbsSdk.cs`
- [SDK configuration](https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/MbsSdkConfig.cs): `src/Sportradar.Mbs.Sdk/MbsSdkConfig.cs`
- [Protocol interfaces](https://github.com/sportradar/mbssdknet/tree/main/src/Sportradar.Mbs.Sdk/Protocol): `src/Sportradar.Mbs.Sdk/Protocol`

### Domain Protocols

- [Ticket operations](https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Internal/Protocol/TicketProtocol.cs): `src/Sportradar.Mbs.Sdk/Internal/Protocol/TicketProtocol.cs`
- [Account operations](https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Internal/Protocol/AccountProtocol.cs): `src/Sportradar.Mbs.Sdk/Internal/Protocol/AccountProtocol.cs`
- [Balance operations](https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Internal/Protocol/BalanceProtocol.cs): `src/Sportradar.Mbs.Sdk/Internal/Protocol/BalanceProtocol.cs`
- [Gaming operations](https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Internal/Protocol/GamingProtocol.cs): `src/Sportradar.Mbs.Sdk/Internal/Protocol/GamingProtocol.cs`
- [Campaign operations](https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Internal/Protocol/CampaignProtocol.cs): `src/Sportradar.Mbs.Sdk/Internal/Protocol/CampaignProtocol.cs`

### Protocol Runtime

- [Request engine](https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Internal/Protocol/ProtocolEngine.cs): `src/Sportradar.Mbs.Sdk/Internal/Protocol/ProtocolEngine.cs`
- [Request handling](https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Internal/Protocol/ProtocolEngine.Request.cs): `src/Sportradar.Mbs.Sdk/Internal/Protocol/ProtocolEngine.Request.cs`
- [Response correlation](https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Internal/Protocol/ProtocolEngine.Response.cs): `src/Sportradar.Mbs.Sdk/Internal/Protocol/ProtocolEngine.Response.cs`
- [Reply dispatcher](https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Internal/Protocol/ProtocolEngine.Dispatcher.cs): `src/Sportradar.Mbs.Sdk/Internal/Protocol/ProtocolEngine.Dispatcher.cs`
- [JSON codec](https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Internal/Utils/Json.cs): `src/Sportradar.Mbs.Sdk/Internal/Utils/Json.cs`

### WebSocket Transport

- [Connection provider](https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Internal/Connection/ConnectionProvider.cs): `src/Sportradar.Mbs.Sdk/Internal/Connection/ConnectionProvider.cs`
- [WebSocket connection](https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Internal/Connection/WebSocketConnection.cs): `src/Sportradar.Mbs.Sdk/Internal/Connection/WebSocketConnection.cs`
- [Token provider](https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Internal/Connection/TokenProvider.cs): `src/Sportradar.Mbs.Sdk/Internal/Connection/TokenProvider.cs`

### Message Models

- [Protocol envelopes](https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Entities/Internal/Request.cs): `src/Sportradar.Mbs.Sdk/Entities/Internal/Request.cs`
- [Response envelope](https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Entities/Internal/Response.cs): `src/Sportradar.Mbs.Sdk/Entities/Internal/Response.cs`
- [Request types](https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Entities/Request/ContentRequestBase.cs): `src/Sportradar.Mbs.Sdk/Entities/Request/ContentRequestBase.cs`
- [Response types](https://github.com/sportradar/mbssdknet/blob/main/src/Sportradar.Mbs.Sdk/Entities/Response/ContentResponseBase.cs): `src/Sportradar.Mbs.Sdk/Entities/Response/ContentResponseBase.cs`

### Other components

- **Integrating app**
- **MBS server**
- **Auth server**

## Connections

- Integrating app → SDK lifecycle: creates and connects (evidence: `README.md`)
- Integrating app → SDK configuration: provides settings (evidence: `README.md`)
- SDK lifecycle → SDK configuration: uses (evidence: `src/Sportradar.Mbs.Sdk/MbsSdk.cs`)
- SDK lifecycle → Protocol interfaces: exposes protocols (evidence: `README.md`)
- SDK lifecycle → Request engine: creates (evidence: `src/Sportradar.Mbs.Sdk/MbsSdk.cs`)
- SDK lifecycle → Ticket operations: exposes (evidence: `src/Sportradar.Mbs.Sdk/MbsSdk.cs`)
- SDK lifecycle → Account operations: exposes (evidence: `src/Sportradar.Mbs.Sdk/MbsSdk.cs`)
- SDK lifecycle → Balance operations: exposes (evidence: `src/Sportradar.Mbs.Sdk/MbsSdk.cs`)
- SDK lifecycle → Gaming operations: exposes (evidence: `src/Sportradar.Mbs.Sdk/MbsSdk.cs`)
- SDK lifecycle → Campaign operations: exposes (evidence: `src/Sportradar.Mbs.Sdk/MbsSdk.cs`)
- Ticket operations → Request handling: submits operations
- Account operations → Request handling: submits operations
- Balance operations → Request handling: submits operations
- Gaming operations → Request handling: submits operations
- Campaign operations → Request handling: submits operations
- Request engine → Connection provider: constructs (evidence: `src/Sportradar.Mbs.Sdk/Internal/Protocol/ProtocolEngine.cs`)
- Request engine → Reply dispatcher: starts dispatchers (evidence: `src/Sportradar.Mbs.Sdk/Internal/Protocol/ProtocolEngine.Dispatcher.cs`)
- Request handling → Protocol envelopes: builds (evidence: `src/Sportradar.Mbs.Sdk/Internal/Protocol/ProtocolEngine.Request.cs`)
- Request handling → Response correlation: awaits reply (evidence: `src/Sportradar.Mbs.Sdk/Internal/Protocol/ProtocolEngine.Request.cs`)
- Response correlation → Request types: serializes content (evidence: `src/Sportradar.Mbs.Sdk/Internal/Protocol/ProtocolEngine.Response.cs`)
- Reply dispatcher → Response envelope: dispatches decoded (evidence: `src/Sportradar.Mbs.Sdk/Internal/Protocol/ProtocolEngine.Dispatcher.cs`)
- Reply dispatcher → Response correlation: correlates reply (evidence: `src/Sportradar.Mbs.Sdk/Internal/Protocol/ProtocolEngine.Dispatcher.cs`)
- JSON codec → Protocol envelopes: serializes (evidence: `src/Sportradar.Mbs.Sdk/Internal/Utils/Json.cs`)
- JSON codec → Response envelope: deserializes (evidence: `src/Sportradar.Mbs.Sdk/Internal/Utils/Json.cs`)
- Protocol envelopes → Request types: contains (evidence: `src/Sportradar.Mbs.Sdk/Entities/Internal/Request.cs`)
- Response envelope → Response types: contains (evidence: `src/Sportradar.Mbs.Sdk/Entities/Internal/Response.cs`)
- Connection provider → WebSocket connection: uses (evidence: `src/Sportradar.Mbs.Sdk/Internal/Connection/WebSocketConnection.cs`)
- WebSocket connection → Token provider: requests tokens (evidence: `src/Sportradar.Mbs.Sdk/Internal/Connection/WebSocketConnection.cs`)
- WebSocket connection → MBS server: connects to (evidence: `README.md`)
- Token provider → Auth server: authenticates with
