Skip to content
Mero.jsMero.jsMero.js

Mero.js

The pure-JavaScript SDK for Calimero. Authenticate to a node, drive the admin API, execute WASM contract methods over JSON-RPC, and stream real-time events over SSE — from the browser, Node, or the edge. Zero dependencies, built on Web Standards.
QuickstartView on GitHub

Get Started

Install the SDK, authenticate to a node, and make your first call in minutes. Quickstart →

Understand

How the SDK is layered — the MeroJs facade, the API clients, the token lifecycle, and the event streams. Read the overview →

Guides

Task guides: contexts & apps, executing WASM methods, real-time subscriptions, groups & governance, blobs, and transport. Browse the guides →

Reference

Every MeroJs method, the full admin & auth API surface, and the three error types. Open the reference →

Architecture at a glance

Section titled “Architecture at a glance”

MeroJs is a thin composition of focused clients over one shared fetch-based transport. It manages the JWT token lifecycle so your code never has to.

Your appbrowser · Node 18+ · Deno · Bun · edge workersMeroJsauthenticate() · setTokenData() · JWT token lifecycle (401 → refresh → retry).authAuthApiClient.adminAdminApiClient.rpcRpcClient.events · .wsSseClient · WsClientHttpClient — fetch transportinjects Authorization: Bearer · single-flight refresh · retry · timeout/abortmerod nodeREST/admin-api · /authJSON-RPC/jsonrpcSSE / WS/sse · /ws

The SDK talks to a Calimero Core node (merod). For the protocol those nodes implement, see the Calimero Core docs. Using React? Reach for @calimero-network/mero-react, which wraps this SDK with hooks.