.NET Error Handling

The .NET SDK throws typed exceptions that extend PostGuardException.

Error Hierarchy

PostGuardException
├── NetworkException        HTTP errors from PKG or Cryptify
└── SealException           Native library encryption errors

PostGuardException

Base class for all SDK errors. Catch this to handle any PostGuard failure.

try
{
    await sealed.UploadAsync();
}
catch (PostGuardException ex)
{
    Console.WriteLine($"PostGuard error: {ex.Message}");
}

NetworkException

Thrown when an HTTP request to the PKG or Cryptify fails.

Property	Type	Description
StatusCode	int	HTTP status code
Body	string	Response body
Url	string	Request URL that failed (PKG or Cryptify endpoint)

catch (NetworkException ex)
{
    Console.WriteLine($"HTTP {ex.StatusCode} at {ex.Url}: {ex.Body}");
}

The exception message follows the same format: HTTP {status} at {url}: {body} (e.g. HTTP 401 at https://pkg.postguard.eu/v2/irma/sign/key: Unauthorized). The Url property lets callers wrapping this SDK distinguish a PKG failure from a Cryptify failure (and which Cryptify phase) without parsing the message.

SealException

Thrown when the native cryptographic library (libpg_ffi) fails during encryption. This typically indicates a problem with the input data or the native library itself.