Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.jurat.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Error Shape

Current responses may include: 
{
  "error": "Request failed"
}
or: 
{
  "reason": "Invalid signer"
}
SDK methods throw an Error using the backend-provided error or reason value when available.

​
Common Error Codes

Jurat API errors may include codes such as:
  • INVALID_SIGNATURE
  • VALIDATION_ERROR
  • CASE_NOT_FOUND
  • CASE_ALREADY_EXISTS
  • CASE_NOT_INITIATED
  • CASE_NOT_PENDING
  • UNSUPPORTED_CHAIN
  • RATE_LIMITED
  • UNAUTHORIZED
  • INTERNAL_ERROR

​
Webhooks

Webhooks notify integrators when long-running recovery state changes. Recommended endpoint format: 
POST https://partner.example.com/webhooks/jurat
Recommended event envelope: 
{
  "id": "evt_abc123",
  "type": "recovery_case.executed",
  "createdAt": "2026-06-01T12:00:00.000Z",
  "data": {
    "caseId": "case-uuid",
    "jrcHash": "0x...",
    "status": "executed",
    "txHash": "0x..."
  }
}

​
Event Types

  • recovery_case.created
  • recovery_case.pending
  • recovery_case.rejected
  • recovery_case.executed
  • recovery_case.action_required

​
Webhook Security

Each webhook should include: 
Jurat-Webhook-Id
Jurat-Webhook-Timestamp
Jurat-Webhook-Signature
The signature should be an HMAC over: 
{timestamp}.{rawBody}
Partners should reject old timestamps and replayed event IDs.