KARMA Developers

Build with KARMA Protocol

Integrate AI Agent payments into your applications. Connect any Agent runtime through open APIs, SDKs, and local tools.

Open Console β†’ Quick Start

πŸš€ Quick Start

Clone & Run

git clone https://github.com/AtoB101/Karma.git cd Karma cp docker/.env.example .env.local docker compose -f docker/docker-compose.example.yml up -d

Coming Soon npm install -g karma-agent && karma-agent init

πŸ“¦ SDK & Tools

πŸ“¦ TypeScript SDK

packages/sdk - Full client library for Node.js and browsers

⚑ CLI Tool

packages/cli - karma-agent command line interface

🐳 Docker

docker/docker-compose.example.yml - One-click local deployment

πŸ”Œ Agent Adapters

examples/ - OpenManus, OpenClaw, Hermes integrations

πŸ”— Core Contracts

πŸ’° NonCustodialAgentPayment

Main payment contract - bill lifecycle, dual-side lock model, disputes

βš–οΈ SettlementEngine

Direct transfer settlement with EIP-712 signature verification

πŸ” AuthTokenManager

Auth token consumption and replay-safe signature validation

πŸ†” KYARegistry

Identity registration and permission hash management

πŸ›‘οΈ CircuitBreaker

Emergency pause and agent-level risk control

πŸ“œ Evidence Schema

packages/evidence-schema/ - Standardized evidence bundle format

πŸ“‘ API Endpoints

πŸ”“ Public APIs (No Auth Required)

  • POST /api/public/agents/register - Register new Agent
  • GET /api/public/agents/:id - Get Agent info
  • GET /api/public/reputation/:address - Query reputation

πŸ”’ Protected APIs (Require API Key)

  • POST /api/v1/bills - Create payment bill
  • POST /api/v1/bills/:id/lock - Lock funds
  • POST /api/v1/bills/:id/release - Release settlement
  • POST /api/v1/bills/:id/dispute - Raise dispute

🧩 Integration Examples

πŸ€– OpenManus Adapter

Connect OpenManus agent to KARMA payment flow

🦾 OpenClaw Adapter

Connect OpenClaw agent with auto-settlement

πŸ“‘ API Service

REST API integration for custom Agent runtimes

πŸ“Š Data Provider

External data feeds with evidence bundling

πŸ”’ Security

  • SECURITY.md - Security reporting and vulnerability disclosure
  • audits/ - Third-party security audit reports
  • docs/SECURITY_AUDIT_2026.md - Latest audit findings
  • Production secrets never belong in git - use .env.local

πŸ“š Documentation

πŸ“– Getting Started

docs/GETTING_STARTED.md - First steps guide

πŸ“– API Reference

docs/API_REFERENCE.md - Complete API documentation

πŸ“– Deployment Guide

docs/DEPLOYMENT.md - Production deployment

πŸ“– SDK Quickstart

docs/sdk-quickstart.md - SDK usage examples

🌐 Network Support

🟒 Ethereum Mainnet

Production environment - 0xdAC17F958D2ee523a2206206994597C13D831ec7 (USDT)

πŸ”΅ Sepolia Testnet

Testing environment for development

πŸ’¬ Community