Skip to main content

Karma concept (brief)

Karma is a 5-factor composite contributor reputation score scaled to 0–100. It is used for provenance/oracle projections and downstream agent weighting.
For the full formula and anti-gaming measures, see: /contributing/karma-attribution.

GET /treasury

Returns current treasury state from config and DB.
curl -s \
  -H "Authorization: Bearer $TOKEN" \
  http://localhost:5050/api/v1/treasury | jq
Example response (200):
{
  "enabled": true,
  "percentage": 0.005,
  "treasury_address": "0x...",
  "pending_intents": 0,
  "receipts": 0
}

Additional karma endpoints

The API also exposes:
  • GET /karma/intents — list pending karma intents
  • POST /karma/settle — record settlement for intent IDs
  • GET /karma/receipts — list settlement receipts

Export karma from the CLI

To export karma in a provenance-friendly format:
b1e55ed export karma --format jsonl --include-chain
Write to a file:
b1e55ed export karma \
  --format jsonl \
  --include-chain \
  --output ./exports/karma.jsonl