Skip to main content

Error Types

The SDK provides built-in errors/exceptions to describe encountered issues during initialization and processing.

Compatibility Error​

Typically related to the initialization of the SDK. The SDK has certain mobile device requirements that pertain to both hardware and software constraints.

Thrown by SashaSDK.init(configuration:) throws(CompatibilityError) during SDK initialization.

Device Not Supported​

  • Device hardware is not compatible
  • iOS/Android version on this device is not compatible with the SDK

Process Error​

Groups all the possible failure points that can happen during the underlying preparation of the components or during embedSignature and lookupSignature methods.

The SDK methods return a Result object, which encapsulates either a success value or an Exception on failure.

Decoding Failure​

  • Image format is not supported
  • Image is corrupted or invalid
  • Image is too small or too large

Network Failure​

  • Network connectivity issues
  • Invalid API key or authentication failure
  • Server errors or timeouts

Preparation Failure​

  • The internal components failed to initialize and/ or allocate resources required for embedding/ looking-up a signature

Signing Failure​

  • Input validation errors: The signature cannot be embedded in the source image
  • The signature cannot be validated and embedded
  • Not enough memory for execution / writing

Lookup Failure​

  • Input validation error: The source image data cannot be checked