# trpc-group/trpc-go architecture

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

- Interactive diagram: https://gitdiagram.com/trpc-group/trpc-go
- Repository: https://github.com/trpc-group/trpc-go

## Overview

tRPC-Go is a pluggable Go RPC framework. A caller invokes the client API, which prepares an RPC and hands it to a transport; on the receiving side, a service handles and encodes the request. Naming, filters, codecs, streaming, and HTTP/REST extend that core workflow, while configuration and plugin registration support replaceable components. The README documents multiple services and protocols. Connections below are limited to README statements and sampled-source or SOURCE INDEX references; unsampled subsystems are represented without speculative call paths.

Main entry points: [`client/client.go`](https://github.com/trpc-group/trpc-go/blob/main/client/client.go) (RPC client), [`server/service.go`](https://github.com/trpc-group/trpc-go/blob/main/server/service.go) (Service handler), [`admin/router.go`](https://github.com/trpc-group/trpc-go/blob/main/admin/router.go) (Admin endpoints), [`transport/client_transport_tcp.go`](https://github.com/trpc-group/trpc-go/blob/main/transport/client_transport_tcp.go) (TCP transport)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client RPC"]
  node_client_api["RPC client<br/>[client.go]"]
  node_selection["Service selection<br/>[options.go]"]
  node_tcp_transport["TCP transport"]
  node_tnet_transport["tnet transport"]
  node_conn_pool["Connection pools<br/>[connection_pool.go]"]
  node_http_client["HTTP client<br/>[client.go]"]
end

subgraph group_server["Server RPC"]
  node_server["Server manager<br/>[server.go]"]
  node_service["Service handler<br/>[service.go]"]
  node_server_transport["Server transport"]
  node_rest_router["REST router<br/>[router.go]"]
end

subgraph group_protocol["Protocols"]
  node_codec_message["Message codec<br/>[message_impl.go]"]
  node_stream_client["Streaming client<br/>[client.go]"]
  node_stream_server["Streaming server<br/>[server.go]"]
end

subgraph group_extensions["Framework Extensions"]
  node_configuration["Configuration<br/>[provider.go]"]
  node_plugins["Plugin setup<br/>[setup.go]"]
end

subgraph group_operations["Operations"]
  node_admin["Admin endpoints<br/>[router.go]"]
  node_metrics["Metrics reports<br/>[metrics_reports.go]"]
  node_metric_sinks["Metrics sinks<br/>[metrics.go]"]
  node_logging["Logging<br/>[log.go]"]
  node_health["Health checks<br/>[health_check.go]"]
end

node_caller(("RPC caller"))

node_caller -->|"invokes"| node_client_api
node_client_api -->|"selects service"| node_selection
node_client_api -->|"encodes messages"| node_codec_message
node_client_api -->|"dispatches RPC"| node_tcp_transport
node_tcp_transport -->|"gets connections"| node_conn_pool
node_tnet_transport -->|"gets connections"| node_conn_pool
node_http_client -->|"invokes"| node_client_api
node_server -->|"registers services"| node_service
node_service -->|"encodes responses"| node_codec_message
node_service -->|"registers router"| node_rest_router
node_service -.->|"uses transport"| node_server_transport
node_stream_client -->|"uses client API"| node_client_api
node_stream_server -->|"uses server API"| node_service
node_admin -->|"reports panics"| node_metrics
node_metrics -->|"records metrics"| node_metric_sinks
node_admin -->|"logs panics"| node_logging
node_plugins -.->|"configures components"| node_configuration

click node_client_api "https://github.com/trpc-group/trpc-go/blob/main/client/client.go"
click node_selection "https://github.com/trpc-group/trpc-go/blob/main/naming/selector/options.go"
click node_tcp_transport "https://github.com/trpc-group/trpc-go/blob/main/transport/client_transport_tcp.go"
click node_tnet_transport "https://github.com/trpc-group/trpc-go/blob/main/transport/tnet/client_transport_tcp.go"
click node_conn_pool "https://github.com/trpc-group/trpc-go/blob/main/pool/connpool/connection_pool.go"
click node_http_client "https://github.com/trpc-group/trpc-go/blob/main/http/client.go"
click node_codec_message "https://github.com/trpc-group/trpc-go/blob/main/codec/message_impl.go"
click node_server "https://github.com/trpc-group/trpc-go/blob/main/server/server.go"
click node_service "https://github.com/trpc-group/trpc-go/blob/main/server/service.go"
click node_server_transport "https://github.com/trpc-group/trpc-go/blob/main/transport/server_transport.go"
click node_rest_router "https://github.com/trpc-group/trpc-go/blob/main/restful/router.go"
click node_stream_client "https://github.com/trpc-group/trpc-go/blob/main/stream/client.go"
click node_stream_server "https://github.com/trpc-group/trpc-go/blob/main/stream/server.go"
click node_admin "https://github.com/trpc-group/trpc-go/blob/main/admin/router.go"
click node_metrics "https://github.com/trpc-group/trpc-go/blob/main/internal/report/metrics_reports.go"
click node_metric_sinks "https://github.com/trpc-group/trpc-go/blob/main/metrics/metrics.go"
click node_logging "https://github.com/trpc-group/trpc-go/blob/main/log/log.go"
click node_configuration "https://github.com/trpc-group/trpc-go/blob/main/config/provider.go"
click node_plugins "https://github.com/trpc-group/trpc-go/blob/main/plugin/setup.go"
click node_health "https://github.com/trpc-group/trpc-go/blob/main/healthcheck/health_check.go"

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_client_api,node_selection,node_tcp_transport,node_tnet_transport,node_conn_pool,node_http_client toneBlue
class node_server,node_service,node_server_transport,node_rest_router toneAmber
class node_codec_message,node_stream_client,node_stream_server toneMint
class node_configuration,node_plugins toneRose
class node_admin,node_metrics,node_metric_sinks,node_logging,node_health,node_caller toneIndigo
```

## Components

### Client RPC

- [RPC client](https://github.com/trpc-group/trpc-go/blob/main/client/client.go): `client/client.go`
- [Service selection](https://github.com/trpc-group/trpc-go/blob/main/naming/selector/options.go): `naming/selector/options.go`
- [TCP transport](https://github.com/trpc-group/trpc-go/blob/main/transport/client_transport_tcp.go): `transport/client_transport_tcp.go`
- [tnet transport](https://github.com/trpc-group/trpc-go/blob/main/transport/tnet/client_transport_tcp.go): `transport/tnet/client_transport_tcp.go`
- [Connection pools](https://github.com/trpc-group/trpc-go/blob/main/pool/connpool/connection_pool.go): `pool/connpool/connection_pool.go`
- [HTTP client](https://github.com/trpc-group/trpc-go/blob/main/http/client.go): `http/client.go`

### Server RPC

- [Server manager](https://github.com/trpc-group/trpc-go/blob/main/server/server.go): `server/server.go`
- [Service handler](https://github.com/trpc-group/trpc-go/blob/main/server/service.go): `server/service.go`
- [Server transport](https://github.com/trpc-group/trpc-go/blob/main/transport/server_transport.go): `transport/server_transport.go`
- [REST router](https://github.com/trpc-group/trpc-go/blob/main/restful/router.go): `restful/router.go`

### Protocols

- [Message codec](https://github.com/trpc-group/trpc-go/blob/main/codec/message_impl.go): `codec/message_impl.go`
- [Streaming client](https://github.com/trpc-group/trpc-go/blob/main/stream/client.go): `stream/client.go`
- [Streaming server](https://github.com/trpc-group/trpc-go/blob/main/stream/server.go): `stream/server.go`

### Framework Extensions

- [Configuration](https://github.com/trpc-group/trpc-go/blob/main/config/provider.go): `config/provider.go`
- [Plugin setup](https://github.com/trpc-group/trpc-go/blob/main/plugin/setup.go): `plugin/setup.go`

### Operations

- [Admin endpoints](https://github.com/trpc-group/trpc-go/blob/main/admin/router.go): `admin/router.go`
- [Metrics reports](https://github.com/trpc-group/trpc-go/blob/main/internal/report/metrics_reports.go): `internal/report/metrics_reports.go`
- [Metrics sinks](https://github.com/trpc-group/trpc-go/blob/main/metrics/metrics.go): `metrics/metrics.go`
- [Logging](https://github.com/trpc-group/trpc-go/blob/main/log/log.go): `log/log.go`
- [Health checks](https://github.com/trpc-group/trpc-go/blob/main/healthcheck/health_check.go): `healthcheck/health_check.go`

### Other components

- **RPC caller**

## Connections

- RPC caller → RPC client: invokes
- RPC client → Service selection: selects service (evidence: `client/client.go`)
- RPC client → Message codec: encodes messages (evidence: `client/client.go`)
- RPC client → TCP transport: dispatches RPC (evidence: `client/client.go`)
- TCP transport → Connection pools: gets connections (evidence: `transport/client_transport_tcp.go`)
- tnet transport → Connection pools: gets connections (evidence: `transport/tnet/client_transport_tcp.go`)
- HTTP client → RPC client: invokes (evidence: `http/client.go`)
- Server manager → Service handler: registers services (evidence: `server/server.go`)
- Service handler → Message codec: encodes responses (evidence: `server/service.go`)
- Service handler → REST router: registers router (evidence: `server/service.go`)
- Service handler → Server transport: uses transport
- Streaming client → RPC client: uses client API (evidence: `stream/client.go`)
- Streaming server → Service handler: uses server API (evidence: `stream/server.go`)
- Admin endpoints → Metrics reports: reports panics (evidence: `admin/router.go`)
- Metrics reports → Metrics sinks: records metrics (evidence: `internal/report/metrics_reports.go`)
- Admin endpoints → Logging: logs panics (evidence: `admin/router.go`)
- Plugin setup → Configuration: configures components
