Audit Logs

Every significant action (payment initiation, settlement, agent suspension) is written to an immutable audit log scoped to the authenticated user.

List logs

GET/auditJWT

Query param	Default
limit	50
offset	0

[
  {
    "id": "uuid",
    "action": "payment_settled",
    "metadata": {
      "paymentId": "uuid",
      "invoiceId": "inv-001",
      "amountUsdCents": 100
    },
    "createdAt": "2026-04-05T03:54:38Z"
  }
]

Logged actions

Action	Trigger
payment_settled	On-chain confirmation received
payment_failed	Submission error
agent_suspended	POST /agents/:id/suspend
pool_topped_up	POST /gas-pool/:id/topup
webhook_registered	POST /webhooks
api_key_revoked	DELETE /keys/revoke