Skip to content
mero-kotlinmero-kotlinmero-kotlin

mero-kotlin

The native Kotlin SDK for Calimero. An Android client for a remote node — coroutine-based auth with automatic token refresh, JSON-RPC contract calls, the full admin API, live SSE events, SSO deep-link login, and an optional Jetpack Compose frontend. Built on OkHttp, kotlinx.serialization, and AndroidX Security.
QuickstartView on GitHub

Get Started

Add the dependency, create a Mero client, authenticate, and make your first call. Quickstart →

Understand

How the SDK is layered — the Mero client, the API clients, the coroutine token lifecycle, and the Compose frontend. Read the overview →

Guides

Task guides: contexts & apps, executing WASM methods, live events, groups & governance, blobs, and the mero-compose layer. Browse the guides →

The device is a thin client

Section titled “The device is a thin client”

mero-kotlin never runs a node. Every capability is a suspend HTTP(S) call to a remote Calimero node. It’s a faithful Kotlin port of the @calimero-network/mero-js wire contract — same endpoints, same auth model — in idiomatic coroutines, and the Android mirror of MeroKit (Swift).

Your app — Jetpack Compose / AndroidminSdk 24 · optional mero-compose (MeroProvider + MeroClient + LoginSheet)Meroauthenticate() · setTokenData() · single-flight token refresh (401 → refresh → retry).authAuthApi.adminAdminApi.rpcRpcClientHttpClient — OkHttp transportBearer auth · single-flight refresh · retry · timeoutTokenStoreEncryptedPrefs · MemoryRemote merod node · HTTP(S)REST/admin-api · /authJSON-RPC/jsonrpcSSE events · /sse

For the protocol those nodes implement, see the Calimero Core docs. For the JavaScript sibling, see Mero.js; for iOS/macOS, MeroKit.