API Reference

API events

Every event the kernel emits — envelope, schema, state, and proof. Versioned, signed, and addressable on the public ledger.

Event envelope

Every event the kernel emits — over stream, REST, or webhook — shares the same envelope. The payload is schema-typed and signed at origin; everything outside payload is kernel-managed and tamper-evident.

event.envelope.json

json

1{
2  "schema":  "trade.delivery.v1",
3  "state":   "STATE_VERIFIED",
4  "proof": {
5    "hash":   "0xA1F4·8B2E·9F11·4C7A",
6    "block":  4128902,
7    "epoch":  2,
8    "ttf_ms": 1184
9  },
10  "attest": {
11    "id":       "RISA·trade",
12    "standard": "ISO/IEC 17025",
13    "verifier": "rRISAv3..."
14  },
15  "payload": {
16    "id":          "RW-004421",
17    "cooperative": "Nyamasheke",
18    "commodity":   "coffee",
19    "kg":          2400,
20    "origin":      { "country": "RW", "geo": "-2.21,28.92" }
21  },
22  "createdAt": "2026-05-15T07:51:04.821Z"
23}

Lifecycle states

CLAIM_RECEIVED — phase I, claim accepted but not verified.
PROOF_ADVANCED — phase II, verifier signature received, awaiting consensus.
STATE_VERIFIED — phase III, finalised. Capital can move.
HOLDING — flagged by an observer for manual review.

Schemas

trade.delivery.v1 — commodity delivery from originator to vector.
carbon.retire.v2 — carbon credit retirement event.
settle.payout.v1 — atomic capital movement on verified state.
insure.claim.v1 — parametric insurance trigger.
credit.score.v1 — verified credit profile update.

REST endpoints

curl-examples.sh

bash

# list verified events in a window
GET https://api.axk.org/v1/events
  ?schema=trade.delivery.v1
  &from=2026-05-01
  &to=2026-05-15
  &limit=200
# fetch a single event by hash
GET https://api.axk.org/v1/events/0xA1F4·8B2E·9F11·4C7A

Webhooks

bash

// register a webhook
POST https://api.axk.org/v1/webhooks
{
  "url":     "https://example.com/axk/inbound",
  "schemas": ["trade.delivery.v1", "settle.payout.v1"],
  "regions": ["rw", "ug", "ke"]
}

Edit this page on GitHub