karvhood
/ 03_SDK_AND_TOOLS

Batteries-included clients for every runtime.

Install once. Get a typed client, a CLI, a wallet helper, error envelopes, and reference adapters for major frameworks.

[01]
QUICK_START

Install in one line.

TERMINALkarv-sdk@1.2.0
# npm
npm install @karv/sdk

# pip
pip install karv-sdk

# initialize
npx karv init --network base --wallet smart

The SDK ships with a zero-config client, a CLI for ops and probing, structured error handling, and adapters for Express, Hono, Fastify, FastAPI, and Next.js.

[02]
COMPONENTS
@karv/sdk
Typed client + middleware
@karv/cli
Wallet, probe, replay, dry-run
@karv/validator
Payload + mesh inspector
@karv/adapters
Framework integrations
[03]
EXAMPLE

Verify and settle a payment.

server.ts
import { karv } from "@karv/sdk";

const facilitator = karv.facilitator({
  endpoint: "https://facilitator.karv.network",
  network: "base",
});

app.post("/premium", async (req, res) => {
  const result = await facilitator.verify(req);
  if (!result.ok) return res.status(402).send(result.challenge);
  await facilitator.settle(result.payload);
  res.json({ data: "..." });
});
[04]
REFERENCE