# Skalor

> Open infrastructure for AI agents transacting on real money. Mandate enforces spending policy on-chain. Bureau gives every agent a signed reputation tier. Pay settles across supported chains. Receipts are Ed25519-signed and verifiable offline.

## Primary documentation

- [/agents](https://skalor.xyz/agents): Machine-readable reference page — primitives, contract addresses, API endpoints, SDK + MCP info.
- [/llms-full.txt](https://skalor.xyz/llms-full.txt): Full reference (under 10k tokens).
- [/open](https://skalor.xyz/open): Public-infrastructure overview — verified contracts, RFC, SDKs, license.
- [/rfc/kya-bureau-v0.1](https://skalor.xyz/rfc/kya-bureau-v0.1): KYA Bureau open spec (draft v0.1).

## Primitives

- **Mandate** — per-agent on-chain spending guard (per-tx limit, daily budget, vendor allowlist, kill switch). Solidity 0.8.24, MIT.
- **Bureau** — federated reputation primitive for AI agents (skalor-agent-rating/v1.3: 0–1000, tiers A–D, published denominator, signed attestations).
- **Pay** — three-rail settlement engine (MPP · x402 · Canton).
- **Receipts** — Ed25519-signed compliance receipts, verifiable offline against published JWKS.

## On-chain (Base Sepolia)

- MandateFactory: 0x61FD854454e954a5B2C2844533A1fbB98eD4aA85
- Mandate (demo): 0xB774bD25Ef8EC3D76f1E024712A6Debb95B1baC3

## SDKs

- TypeScript: npm install @skalor/sdk
- Python: pip install skalor-sdk
- MCP server: https://mcp.skalor.xyz

## API base

https://augvmbhpuchkqqowxmrk.supabase.co/functions/v1/

Public endpoints:
- GET /bureau/agents/<uuid or did:key:...> — skalor-agent-rating/v1.3 for one agent
- GET /bureau/agents/<id>/attestation — the same rating plus a signed EdDSA JWT
- GET /bureau/method — the published rating method
- GET /bureau/.well-known/did.json — the attestation signing key (did:web:skalor.xyz)
- GET /bureau-list — public registry (identities of opted-in agents)
- GET /bureau-crl — Certificate Revocation List

Authenticated endpoints (Authorization: Bearer zc_<key>):
- POST /authorize-intent — 7 fiduciary gates + clear on settlement rail
- POST /skalor-pay — A2A agent-to-agent settlement
- POST /canton-pay — Canton rail

## Receipt formats

- skalor_v1.<payload>.<sig> — transaction attestation v1
- skalor_v2.<payload>.<sig> — transaction attestation v2 (Gate 0 included)
- skalor_bureau_v1.<payload>.<sig> — bureau score receipt

JWKS: https://skalor.xyz/.well-known/skalor-key.json

## License

MIT. Source: https://github.com/SkalorAI/skalor-protocol

## Contact

founders@skalor.xyz