NAME

Mail::DKIM2::Validate - structured per-level DKIM2 and Message-Instance report

SYNOPSIS

my $report = Mail::DKIM2::Validate::report($message_text,
    PubkeyCallback     => \&lookup,   # optional; default DNS
    DnsPath            => $dns_json,  # optional interop override
    SkipTimestampCheck => 1,
);
# $report->{overall}, $report->{summary}, $report->{counts},
# $report->{levels}: one hashref per DKIM2-Signature and Message-Instance

DESCRIPTION

Walks a DKIM2 message top-down and returns a breakdown of every DKIM2-Signature and Message-Instance level, including each undo step, for the dkim2.com web validator and the validate.pl tool to display. Never dies. See docs/superpowers/specs/2026-06-18-dkim2-web-validator-design.md.

FUNCTIONS

report($message_text, %options)

Options PubkeyCallback, DnsPath and SkipTimestampCheck as above. Returns the report hashref.

AUTHOR

Bron Gondwana <brong@fastmailteam.com>

COPYRIGHT AND LICENSE

Copyright (c) 2025-2026 Fastmail Pty Ltd. This is free software; you can redistribute it and/or modify it under the same terms as Perl itself.