mik-sdk

Portable WASI HTTP SDK using Component Composition

Write handlers once, run on any WASI-compliant runtime.

What is mik-sdk?

mik-sdk provides an ergonomic way to build portable WebAssembly HTTP handlers in pure Rust. It uses a two-component architecture where your handler logic is composed with a bridge component that handles WASI HTTP translation.

use mik_sdk::prelude::*;

routes! {
    GET "/" => home,
    GET "/hello/{name}" => hello(path: HelloPath),
    POST "/users" => create_user(body: CreateInput),
}

fn home(_req: &Request) -> Response {
    ok!({ "message": "Welcome to mik-sdk!" })
}

fn hello(path: HelloPath, _req: &Request) -> Response {
    ok!({ "greeting": format!("Hello, {}!", path.name) })
}

Key Features

Type-Safe Routing

Define routes with automatic path, query, and body extraction using derive macros.

Pure Rust JSON

Fast JSON parsing and building with lazy evaluation - no external calls.

Minimal Size

Composed components are ~200KB - optimized for edge deployment.

Portable

Run on any WASI HTTP runtime - build once, deploy anywhere.

Architecture Overview

mik-sdk uses a two-component architecture for WASI HTTP portability:

Component	Purpose	Size
Handler	Your business logic + JSON/time/random	~158KB
Bridge	WASI HTTP adapter	~72KB
Composed	Complete service	~230KB

Quick Links

Installation Set up your development environment

Quick Start Build your first handler in minutes

Routing Learn the routing system

API Reference Complete API documentation

Why mik-sdk?

Ergonomic API

#[derive(Type)]
pub struct CreateUserInput {
    #[field(min = 1, max = 100)]
    pub name: String,
    #[field(format = "email")]
    pub email: String,
}

fn create_user(body: CreateUserInput, _req: &Request) -> Response {
    // body is already parsed and validated
    ok!({ "name": body.name, "email": body.email })
}

Fast JSON Handling

Lazy JSON parsing extracts only the fields you need - up to 33x faster than full tree parsing:

let parsed = req.json()?;  // Parse request body
let name = parsed.path_str(&["user", "name"]);  // ~100ns
let age = parsed.path_int(&["user", "age"]);    // ~100ns

Native WASI Integration

Uses native WASI interfaces automatically on WebAssembly:

• wasi:clocks/wall-clock for time
• wasi:random/random for cryptographic randomness
• wasi:http/outgoing-handler for HTTP client (optional)

SQL Query Builder

Build parameterized SQL queries with Mongo-style filter syntax:

let (sql, params) = sql_read!(users {
    select: [id, name, email],
    filter: { active: true, age: { $gte: 18 } },
    order: [-created_at, id],
    limit: 20,
});

Project Status

Experimental

mik-sdk is an experimental project for learning and internal use. It demonstrates WASI P2, WAC composition, and component model patterns.