Developer Documentation

Quickstart

Four commands. A signed-and-running single-node devnet on your laptop. The same binary covers wallet generation, node operation, genesis config and the gateway - no client/server install dance.

# 1. Install the karoowa binary
curl -fsSL https://install.karoowa.io | sh

# 2. Generate a validator wallet
karoowa wallet new --output ./validator.key

# 3. Start a single-node devnet (PoA)
karoowa node \
  --validator-key ./validator.key \
  --consensus poa \
  --data-dir ./.karoowa/data \
  --rpc-port 8545 \
  --p2p-port 30303

# 4. Hit the gateway
curl -s http://localhost:8545/health

What you will find here

• Getting started

  Install the karoowa binary, generate a wallet, run a devnet and hit the JSON-RPC gateway in one shell session. Pre-built binaries verified by Sigstore signatures and SLSA build attestations on every tagged release.

• Architecture

  Block, transaction, state and receipt primitives; pluggable consensus (PoA, PoS, BFT); RocksDB-backed storage with Zstandard compression; libp2p (Gossipsub + Kademlia) for the P2P layer; an Axum gateway exposing JSON-RPC, REST and WebSocket on a single port.

• SDK reference

  karoowa-sdk: the first-party Rust crate. Wallet (Ed25519), NodeClient, transaction builders for EIP-2718 / EIP-2930 / EIP-1559 envelopes. From other languages, generate clients from the OpenAPI spec and call the gateway directly.

• Contracts (WASM)

  A wasmtime-backed VM with fuel metering and memory limits. Deploy compiled WASM modules through the gateway, invoke them from the SDK, observe state transitions through receipts and the Merkle trie.

• Operators

  Multi-validator devnets via Docker Compose; genesis configuration; observability through structured logs and Prometheus metrics; release verification via gh attestation verify against the mmxxdynamics/karoowa repo.

• Agents

  Karoowa ships an LLM runtime (OpenAI- and Anthropic-backed) with first-class agent bundles for governance, operations and security. Agents run alongside the node and consume the same gateway as any other client.