Error Codes | BASIS

Overview

BASIS defines a comprehensive error taxonomy with 60+ error codes organized into 12 categories. All errors follow a consistent format and include actionable information for debugging and monitoring.

Error Response Format

{
  "error_code": "E1201",
  "error_category": "INTENT",
  "error_message": "Failed to parse action intent",
  "timestamp": "2026-01-15T10:30:00Z",
  "request_id": "req_abc123xyz",
  "details": {
    "parse_stage": "extraction",
    "failure_reason": "Ambiguous action target"
  },
  "retryable": false,
  "retry_after": null,
  "documentation_url": "https://vorion.org/basis/errors#E1201"
}

Error Categories

Category	Code Range	Description
TRUST	E1000-E1099	Trust score errors
CAPABILITY	E1100-E1199	Capability check failures
INTENT	E1200-E1299	Intent parsing errors
ENFORCE	E1300-E1399	Policy enforcement errors
PROOF	E1400-E1499	Proof generation/verification
CHAIN	E1500-E1599	Blockchain anchoring
ENTITY	E1600-E1699	Entity management
POLICY	E1700-E1799	Policy configuration
RATE_LIMIT	E1800-E1899	Rate limiting
SYSTEM	E1900-E1999	System-level errors
AUTH	E2000-E2099	Authentication/authorization
VALIDATION	E2100-E2199	Input validation

Common Error Codes

E1010TRUSTRetryable

Trust score unavailable

Cannot retrieve entity trust score. Usually transient database issue.

E1103CAPABILITYNot Retryable

Capability not granted

Entity does not have required capability. Check trust tier or request capability grant.

E1201INTENTNot Retryable

Failed to parse action intent

Could not extract structured intent from input. Reformulate request.

E1310ENFORCERetryable

Governance unavailable

ENFORCE layer cannot evaluate. System defaults to DENY.

E1403PROOFNot Retryable

Proof chain integrity violation

Hash chain verification failed. SECURITY ALERT: Potential tampering.

E2001AUTHNot Retryable

Authentication required

No valid authentication provided. Include API key or token.

For the complete error taxonomy with all 60+ codes, see the full document on GitHub.

View All Error Codes on GitHub