namespace Svrnty.CQRS.Altcha.Abstractions;

/// <summary>
/// Verifies an Altcha solution payload. The default implementation in
/// <c>Svrnty.CQRS.Altcha.Grpc</c> talks to a self-hosted altcha service
/// over gRPC; consumers may register their own implementation (e.g. an
/// in-process variant or a different transport) and the
/// <see cref="ICommandAuthorizationCheck"/>-based pipeline picks it up
/// automatically.
/// </summary>
public interface IAltchaVerifier
{
    /// <param name="payload">
    /// Base64-encoded JSON payload produced by the Altcha widget — the same
    /// string carried on <see cref="IHasAltchaSolution.AltchaSolution"/>.
    /// </param>
    Task<AltchaVerifyResult> VerifyAsync(string payload, CancellationToken cancellationToken = default);
}