Home / Developers
Developers · Confidential apps
Build on Calimero. Write the logic.
Build a confidential app: write its logic in Rust, bundle it with its frontend into one signed package, and run it on Calimero Cloud: on shared clusters, paying per request, or on a dedicated cluster of your own.
use calimero_sdk::prelude::*; #[app::state(version = 1)] pub struct KvStore { items: UnorderedMap<String, String>, } #[app::event] pub enum Event { Inserted { key: String, value: String }, Updated { key: String, value: String }, } #[app::logic] impl KvStore { #[app::init] pub fn init() -> app::Result<Self> { Ok(Self::load()) } pub fn set(&mut self, key: String, value: String) -> app::Result<()> { let event = match self.items.insert(&key, &value)? { Some(_) => Event::Updated { key, value }, None => Event::Inserted { key, value }, }; env::emit(event, Audience::All)?; Ok(()) } #[app::view] pub fn get(&self, key: String) -> app::Result<Option<String>> { Ok(self.items.get(&key)?) } }
Replicated across attested nodes. No server code.
- 1command line for every stage:
meroctl - 1signed package: logic and frontend together
- 10open-source tools and libraries
- 6client libraries: JavaScript, React, Python, Swift, Kotlin, Rust
01 · Quickstart
From an empty folder to a running app.
Install meroctl, start from the KV Store reference app and run it on a local cluster with its frontend. By hand, sign in with a development passkey, create an app instance and call it. Deploy signs the same app into a package for Calimero Cloud.
curl -fsSL https://raw.githubusercontent.com/calimero-network/core/master/scripts/install.sh | sh -s -- merod meroctl meroctl app new my-app && cd my-app pnpm install meroctl local dev apps/kv-store # A local cluster on 127.0.0.1:2501, the app built and uploaded, # its frontend on http://localhost:5173, rebuilt on every save.
meroctl local up runs the node in Docker by default, so it works on Linux and macOS; --local uses a merod on your PATH instead.
meroctl local up meroctl login --dev-passkey ./dev-passkey.json --name ada meroctl app build apps/kv-store --out kv_store.wasm meroctl instance create --path kv_store.wasm --name kv --alias kv meroctl call --instance kv set --args '{"key":"a","value":"1"}' meroctl call --instance kv get --args '{"key":"a"}' --view meroctl local down
meroctl app signer new release.key meroctl app pack apps/kv-store/logic --key release.key --out release.mpk meroctl app inspect release.mpk meroctl app publish release.mpk --org <your-org> # In the Cloud console: deploy it to staging, promote it to production, # create an API key. export CALIMERO_API_KEY=cal_... CALIMERO_TEE_PROFILES=locked-read-only meroctl node add prod https://<your-cluster>/ meroctl attest app <instance> meroctl call -i <instance> get --args '{"key":"a"}' --view
Calimero Cloud runs signed packages only. meroctl app publish puts yours in Calimero's registry, private unless you make it public; every node that runs one checks the publisher's signature. Raw WASM uploads are for local dev clusters. Against Calimero Cloud, meroctl takes an API key and the node images you trust, and checks each node's attestation before it sends anything. Upgrades are confirmed with the owner's passkey.
meroctl's names: app is a signed package, instance an app instance, namespace an organization and group one of its teams.
02 · Tools and SDKs
Everything you need, one install away.
The node, the command-line tools, the app SDK and the clients. Each is open source.
Node & CLI
Develop and test locally.
-
merodThe node, for Linux.
meroctl local upruns a development cluster with mock attestation, in Docker by default (--nodes 3for three nodes,--localfor amerodon your PATH).curl -fsSL https://raw.githubusercontent.com/calimero-network/core/master/scripts/install.sh | sh -s -- merod meroctl -
meroctlThe one command line: start an app, build, pack, sign and publish it, run a local cluster around it, call app instances and work with Calimero Cloud.
curl -fsSL https://raw.githubusercontent.com/calimero-network/core/master/scripts/install.sh | sh -s -- meroctl -
meroctl, stage by stage- Start
app new DIR [--template T]- Build
app buildapp codegen --lang ts|python|swift|kotlin|openapiapp abi show|diff- Ship
app signer newapp pack [--key K] [--previous OLD]app signapp inspectapp publish [--org ORG]- Run locally
local up|down|status [--local]local devlocal testlocal compute run- Cloud
cloud logincloud orgscloud clusters list|createcloud use CLUSTERcloud compute pipeline|logs
All tools and libraries: app SDK, clients, examplesShow less
App SDK
Write the app.
-
calimero-sdkWrite app logic in Rust, built for
wasm32-wasip2into acalimero:appcomponent.cargo add --git https://github.com/calimero-network/core calimero-sdk
Clients
Talk to a node from your code.
-
calimero-clientRust client: verifies a node's attestation, then seals every request.
meroctland the Python client are built on it.cargo add --git https://github.com/calimero-network/core calimero-client -
calimero-client-pyPython client for Calimero 1.0, version 3.2:
Client, with passkey and API key sign-in.pip install calimero-client-py -
mero-jsJavaScript and TypeScript client for Calimero 1.0, version 35.2:
CalimeroClient, with passkey sign-in, for the browser and Node.npm install @calimero-network/mero-js -
mero-reactReact binding, version 11.1: one
CalimeroClientin context, with hooks and components for sign-in, sessions, app calls and events.npm install @calimero-network/mero-react -
MeroKitSwift SDK for iOS and macOS, version 6.0: attestation, the sealed channel, passkeys and app instances.
.package(url: "https://github.com/calimero-network/swift-sdk", from: "6.0.0")
-
mero-kotlinAndroid SDK, version 5.0: attestation, the sealed channel, passkeys, and app intents and views.
implementation("com.calimero.mero:mero-core:5.0.0")
03 · Calimero MCP
Let any agent drive your apps.
Any agent, local, deployed or from a frontier lab, gets its own scoped API key, so the Calimero MCP can drive your apps under each app's rules. Coding agents such as Claude Code, Cursor and Codex CLI included.
- Its own key, separate from yours, revocable any time.
- The app's rules apply to the agent like any other member.
- Sensitive methods can require a person's fresh passkey confirmation.
04 · Docs and open source
The runtime is open source.
The node, the SDK and the protocol are on GitHub, with a full protocol reference you could reimplement a node from. The docs come in four tracks.
- Stars
- Latest release
- Docs
- Build · Operate · Protocol · Contribute
05 · Showcase
Learn from working apps.
Chat, documents, spreadsheets, a password manager, private polls, e-signatures and games, each a real app in the apps repo with its code.
- Products
Apps
Real apps with their code, and the App Registry of signed apps.
See the demos - Docs
Examples
Every example app in the core repo, explained.
Read the examples - Platform
How it works
What every node brings so your app doesn't have to: runtime, replicated state, storage, networking and keys.
Read how it works
Your customers want control. You want to ship.
Start on Calimero Cloud, or build on the open-source runtime.