---
name: rpcgen
description: "Rpcgen — генерация клиентов из SMD/OpenRPC для Go, TypeScript, PHP, Swift, Kotlin, Dart. Используй при подключении клиента к чужому RPC-сервису или публикации собственного SMD/OpenRPC-контракта."
---

# Rpcgen

Upstream: https://github.com/vmkteam/rpcgen

Генерирует типизированные клиенты из SMD (Service Mapping Description) zenrpc-сервера. Связанный инструмент — **rpcdiff** (diff OpenRPC schema для breaking-changes в CI).

Tool-зависимость:
```go
tool github.com/vmkteam/rpcgen/v2/cmd/rpcgen
```

## Языки и API

`gen.GoClient`, `gen.TSClient`, `gen.PHPClient`, `gen.SwiftClient`, `gen.KotlinClient`, `gen.DartClient`, `gen.OpenRPC(name, url)`.

CLI — через `-lang <go|typescript|php|swift|kotlin|dart>`, источник `-url` (SMD endpoint) или `-file smd.json`, вывод `-o`. Полный список флагов — `rpcgen --help`.

## vmkteam-паттерн: on-the-fly handler

Сервер раздаёт клиенты с собственных endpoint'ов через `rpcgen.Handler`:

```go
a.echo.Any("/v1/rpc/api.ts",   appkit.EchoHandlerFunc(rpcgen.Handler(gen.TSClient(typeMapper))))
a.echo.Any("/v1/rpc/api.go",   appkit.EchoHandlerFunc(rpcgen.Handler(gen.GoClient(golang.Settings{Package: appName}))))
a.echo.Any("/v1/rpc/api.swift",     appkit.EchoHandlerFunc(rpcgen.Handler(gen.SwiftClient(swift.Settings{Class: "API", TypeMapper: swiftTypeMapper}))))
a.echo.Any("/v1/rpc/networking.swift", appkit.EchoHandlerFunc(rpcgen.Handler(gen.SwiftClient(swift.Settings{IsProtocol: true, TypeMapper: swiftTypeMapper}))))
a.echo.Any("/v1/rpc/api.kt",        appkit.EchoHandlerFunc(rpcgen.Handler(gen.KotlinClient(kotlin.Settings{Class: "Api", PackageAPI: "com.example.api", TypeMapper: kotlinTypeMapper}))))
a.echo.Any("/v1/rpc/networking.kt", appkit.EchoHandlerFunc(rpcgen.Handler(gen.KotlinClient(kotlin.Settings{Class: "Api", PackageAPI: "com.example.api", IsProtocol: true}))))
a.echo.Any("/v1/rpc/openrpc.json",  appkit.EchoHandlerFunc(rpcgen.Handler(gen.OpenRPC("service", rpcUrl))))
```

- `IsProtocol: true` для Swift/Kotlin → protocol/interface вместо class/data class
- `TypeMapper func(schema, current) string` — переопределение типов per-язык

## Makefile-цели (vmkteam-конвенция)

```makefile
go-client:
	rpcgen -lang go -url http://localhost:$(PORT)/rpc/ -o ./pkg/client/$(NAME)/

type-script-client: generate
	rpcgen -lang typescript -url http://localhost:$(PORT)/rpc/ -o ../frontend/src/api/factory.generated.ts
	rpcgen -lang typescript -url http://localhost:$(PORT)/vt/ -o ../frontend/src/api/vt.generated.ts
```

## Gotchas

- **TS:** после генерации добавить `// @ts-nocheck` на 3-ю строку (после `/* eslint-disable */`), иначе frontend не собирается
- Go-клиенты импортируются как `project/pkg/client/<service>`, инициализация `svc.New("http://host/rpc/")`
- `rpcdiff old.json new.json` — сравнение OpenRPC schema, полезно перед деплоем

## Маркер

`// Code generated by rpcgen; DO NOT EDIT.`