Kaledge

1# Kaledge
2 
3**The clearing layer for machine commerce.**
4 
5When AI agents transact at scale, someone has to settle. That's Kaledge.
6 
7[![npm](https://img.shields.io/npm/v/@primordia1/mcp-server)](https://www.npmjs.com/package/@primordia1/mcp-server)
8[![Kernel](https://img.shields.io/badge/kernel-live-brightgreen)](https://primordia-kernel.fly.dev/healthz)
9[![Docs](https://img.shields.io/badge/docs-kaledge.app-blue)](https://kaledge.app/docs.html)
10 
11## What is Kaledge?
12 
13Kaledge provides financial infrastructure for AI agents:
14 
15- **MSR** (Machine Settlement Receipt) - Cryptographic proof of every transaction
16- **IAN** (Inter-Agent Netting) - Compress 1,000 transactions into 12 net obligations
17- **MBS** (Machine Balance Sheet) - Real-time balance sheet per agent
18- **CL** (Credit Line) - Agents operate before payment settles
19- **DBP** (Default Protocol) - Automatic creditor waterfall when agents fail
20 
21## Why?
22 
23AI agents are economic actors. They consume compute, call APIs, transact with each other.
24 
25Without settlement infrastructure:
26- No receipts → disputes unresolvable
27- No netting → 1000x settlement overhead
28- No credit → agents block on payment
29- No default handling → legal disputes
30 
31## Quick Start
32 
33### SDK (TypeScript)
34 
35```bash
36npm install @primordia1/sdk
37```
38 
39```typescript
40import { createMSR, verifyMSR } from '@primordia1/sdk';
41 
42// Create settlement receipt
43const receipt = createMSR({
44  from_agent: 'agent_a_pubkey',
45  to_agent: 'agent_b_pubkey',
46  amount_micros: 50_000_000, // $50
47  currency: 'USD',
48  memo: 'Compute services'
49}, privateKey);
50 
51// Verify receipt
52const valid = verifyMSR(receipt);
53```
54 
55### MCP Server (Claude, Cursor, Windsurf)
56 
57```bash
58npx @primordia1/mcp-server
59```
60 
61Add to your MCP config:
62 
63```json
64{
65  "mcpServers": {
66    "kaledge": {
67      "command": "npx",
68      "args": ["@primordia1/mcp-server"]
69    }
70  }
71}
72```
73 
74Tools available:
75- `verify_receipt` - Verify any settlement receipt
76- `generate_mbs` - Generate agent balance sheet
77- `net_receipts` - Net multiple receipts
78 
79### Runtime Hooks (Zero-code)
80 
81```python
82from primordia import wrap_openai
83 
84client = wrap_openai(OpenAI(), shadow=True)
85# Every call now emits MSR automatically
86```
87 
88## Economics
89 
90| Operation | Fee |
91|-----------|-----|
92| Netting | 5 bps on netted volume |
93| Credit | 200 bps spread |
94| Default Resolution | $25,000 |
95 
96**Free tier:** Generate receipts locally, verify signatures, shadow mode.
97 
98## Architecture
99 
100```
101┌─────────────┐     ┌─────────────┐     ┌─────────────┐
102│   Agent A   │────▶│    MSR      │────▶│   Agent B   │
103└─────────────┘     └─────────────┘     └─────────────┘
104                          │
105                          ▼
106                    ┌─────────────┐
107                    │   Kernel    │  ← Signs IAN
108                    └─────────────┘
109                          │
110                          ▼
111                    ┌─────────────┐
112                    │    IAN      │  ← Net obligations
113                    └─────────────┘
114```
115 
116## Links
117 
118- **Website:** https://kaledge.app
119- **Documentation:** https://kaledge.app/docs.html
120- **Quickstart:** https://kaledge.app/quickstart.html
121- **Kernel API:** https://primordia-kernel.fly.dev
122- **MCP Server:** https://www.npmjs.com/package/@primordia1/mcp-server
123 
124## Primitives Reference
125 
126| Primitive | Purpose |
127|-----------|---------|
128| MSR | Machine Settlement Receipt - signed proof of transaction |
129| IAN | Inter-Agent Netting - compressed net obligations |
130| MBS | Machine Balance Sheet - agent financials |
131| CL | Credit Line - agent lending |
132| DRAW/REPAY | Credit utilization tracking |
133| DBP | Default/Bankruptcy Protocol |
134| FC | Future Commitment - forward obligations |
135| AMR/CMR | Attested Meter Receipts - consumption proofs |
136| SEAL | ClosePacket - period reconciliation proof |
137 
138## License
139 
140MIT
141 
142---
143 
144**The machine economy needs clearing. We're building it.**
145