Package zeroecho.core.err

package zeroecho.core.err

Exception types used by the core to signal configuration errors and unexpected provider failures.

This package defines a small, clear taxonomy of exceptions thrown when constructing or running cryptographic contexts. Use these types to distinguish programming/configuration mistakes from lower-level provider failures.

Exception categories

• UnsupportedRoleException - the requested KeyUsage is not supported by the selected algorithm, or the role is incompatible with the supplied key/spec.
• UnsupportedSpecException - the provided ContextSpec is invalid or incompatible with the requested role or key.
• ProviderFailureException - an unexpected failure surfaced by an underlying JCA/JCE/PQC provider; the operation cannot proceed safely.

Usage notes

• Treat UnsupportedRoleException and UnsupportedSpecException as programming or configuration errors that should be fixed by adjusting inputs.
• Treat ProviderFailureException as an operational fault (provider bug, environment issue); log with context and surface a safe error to callers.

Typical usage

try {
    zeroecho.core.context.EncryptionContext ctx =
        algo.createContext(zeroecho.core.KeyUsage.ENCRYPT, key, spec);
    // use ctx...
} catch (zeroecho.core.err.UnsupportedRoleException
       | zeroecho.core.err.UnsupportedSpecException e) {
    // programming error: wrong role or incompatible key/spec
    throw new IllegalArgumentException("Bad configuration", e);
} catch (java.io.IOException e) {
    // I/O failure when initializing context
    ...
} catch (zeroecho.core.err.ProviderFailureException e) {
    // unexpected provider failure: wrap, log, or abort
    ...
}

Since:

1.0

Related Packages

Package	Description
zeroecho.core	Core cryptography engine and registry for ZeroEcho.

Exception Classes

Class	Description
ProviderFailureException	Exception signaling a failure in the underlying cryptographic provider during algorithm initialization or operation.
UnsupportedRoleException	Exception indicating that an algorithm does not support the requested role.
UnsupportedSpecException	Exception indicating that a provided key/spec combination is not supported by the algorithm for the requested role.
VerificationException	Exception thrown when a cryptographic signature or digest verification fails.