Kaledge

The clearing layer for machine commerce.

When AI agents transact at scale, someone has to settle. That's Kaledge.

What is Kaledge?

Kaledge provides financial infrastructure for AI agents:

• MSR (Machine Settlement Receipt) - Cryptographic proof of every transaction
• IAN (Inter-Agent Netting) - Compress 1,000 transactions into 12 net obligations
• MBS (Machine Balance Sheet) - Real-time balance sheet per agent
• CL (Credit Line) - Agents operate before payment settles
• DBP (Default Protocol) - Automatic creditor waterfall when agents fail

Why?

AI agents are economic actors. They consume compute, call APIs, transact with each other.

Without settlement infrastructure:

• No receipts → disputes unresolvable
• No netting → 1000x settlement overhead
• No credit → agents block on payment
• No default handling → legal disputes

Quick Start

SDK (TypeScript)

npm install @primordia1/sdk

import { createMSR, verifyMSR } from '@primordia1/sdk';

// Create settlement receipt
const receipt = createMSR({
  from_agent: 'agent_a_pubkey',
  to_agent: 'agent_b_pubkey',
  amount_micros: 50_000_000, // $50
  currency: 'USD',
  memo: 'Compute services'
}, privateKey);

// Verify receipt
const valid = verifyMSR(receipt);

MCP Server (Claude, Cursor, Windsurf)

npx @primordia1/mcp-server

Add to your MCP config:

{
  "mcpServers": {
    "kaledge": {
      "command": "npx",
      "args": ["@primordia1/mcp-server"]
    }
  }
}

Tools available:

• verify_receipt - Verify any settlement receipt
• generate_mbs - Generate agent balance sheet
• net_receipts - Net multiple receipts

Runtime Hooks (Zero-code)

from primordia import wrap_openai

client = wrap_openai(OpenAI(), shadow=True)
# Every call now emits MSR automatically

Economics

Free tier: Generate receipts locally, verify signatures, shadow mode.

Architecture

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   Agent A   │────▶│    MSR      │────▶│   Agent B   │
└─────────────┘     └─────────────┘     └─────────────┘
                          │
                          ▼
                    ┌─────────────┐
                    │   Kernel    │  ← Signs IAN
                    └─────────────┘
                          │
                          ▼
                    ┌─────────────┐
                    │    IAN      │  ← Net obligations
                    └─────────────┘

Links

• Website: https://kaledge.app
• Documentation: https://kaledge.app/docs.html
• Quickstart: https://kaledge.app/quickstart.html
• Kernel API: https://primordia-kernel.fly.dev
• MCP Server: https://www.npmjs.com/package/@primordia1/mcp-server

Primitives Reference

License

MIT

The machine economy needs clearing. We're building it.