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

ValidationError

Thrown by PolicyBuilder.build when validation reports any issue.

Carries every issue the validator found. The Error.message is the first issue's message — a diagnostic summary, not a presentation contract. Consumers rendering issues to users should iterate issues directly.

Git Source

PolicyViolationError

Thrown by PolicyEnforcer.enforce when calldata fails policy enforcement. Distinct from ValidationError, 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.

Each code names one invariant and matches the Solidity error raised for the same invariant, transliterated from PascalCase to SCREAMING_SNAKE_CASE.

Git Source