The Financial Governance Layer for
AI Agents Transacting with the Real World

import { UMP } from "@umpledger/sdk";

// 1. Initialize
const ump = new UMP({ apiKey: "ump_sk_..." });

// 2. Register your AI agent with spending limits
const agent = ump.registerAgent({
  name: "my-coding-agent",
  type: "AI_AGENT",
  authority: { maxPerTransaction: "$50", maxPerDay: "$500" }
});

// 3. Fund the wallet
agent.wallet.fund({ amount: "$100" });

// 4. Call another agent's service - billing happens automatically
const result = await ump.transact({
  from: agent.id,
  to: "agent_claude_api",
  service: "code_review",
  payload: { repo: "github.com/acme/app", pr: 42 }
});

// result.cost = "$0.12" (auto-metered, auto-rated, auto-orchestrated)
// result.outcome = { type: "TASK_COMPLETION", confidence: 0.95 }
// result.audit_id = "aud_7f3a9bc2" (full audit trail)

# 1. Register an agent (local server)
curl -X POST http://localhost:3000/ump/v2/agents \
  -H "X-API-Key: ump_sk_test_local" \
  -H "Content-Type: application/json" \
  -d '{"name":"my-agent","agent_type":"AI_AGENT","authority":{"maxPerTransaction":10,"maxPerDay":1000}}'

# Response: { "agent_id": "agent_...", "wallet_id": "wallet_..." }

# 2. Fund the wallet (use wallet_id from response above)
curl -X POST http://localhost:3000/ump/v2/wallets/{wallet_id}/fund \
  -H "X-API-Key: ump_sk_test_local" \
  -H "Content-Type: application/json" \
  -d '{"amount":100,"currency":"USD"}'

# 3. Create a contract between agents
curl -X POST http://localhost:3000/ump/v2/contracts \
  -H "X-API-Key: ump_sk_test_local" \
  -H "Content-Type: application/json" \
  -d '{"source_agent_id":"agent_abc","target_agent_id":"agent_def","service_name":"my-service","pricing_rules":[{"primitive":"FLAT_FEE","amount":5.00,"currency":"USD"}]}'

# 4. Execute a transaction (use contract_id from contract response)
curl -X POST http://localhost:3000/ump/v2/transact \
  -H "X-API-Key: ump_sk_test_local" \
  -H "Content-Type: application/json" \
  -d '{"from":"agent_abc","to":"agent_def","contract_id":"contract_xyz","service":"my-service","payload":{"application_id":"app_001"}}'

# Response: {"transaction_id":"txn_...","cost":5,"currency":"USD","outcome":"COMPLETED","audit_id":"audit_...","duration_ms":0}