Errors

CallciumError

Thrown when a policy or descriptor blob is structurally malformed. The optional offset indicates the byte position in the source blob where the error was detected.

Git Source

PolicyViolationError

Thrown by PolicyEnforcer.enforce when calldata fails policy enforcement. Distinct from CallciumError("VALIDATION_ERROR"), which signals static issues in the policy itself.

Carries the full list of structured violations (one per failed group). The Error.message is a minimal non-lossy diagnostic summary built from the first violation's structured fields — not a presentation contract. Consumers rendering violations to users should iterate violations directly.

Git Source

Types

CallciumErrorCode

Machine-readable error code for structural decoding and validation failures.

Git Source