# WKD Tester

> A web-based tool for testing and debugging OpenPGP Web Key Directory (WKD) protocol, providing both a user-friendly interface and a REST API for key discovery.

WKD Tester allows users to lookup OpenPGP public keys using e-mail addresses through the Web Key Directory protocol. It supports both Advanced and Direct lookup methods as defined in the IETF draft, providing detailed results including key fingerprints, algorithm information, expiry dates, randomart visualization, and comprehensive error reporting.

## API Documentation

- [WKD Tester API](/api-docs/ui/): Interactive Swagger UI for testing and exploring the API endpoints
- [OpenAPI Specification](/api-docs/openapi.json): Machine-readable OpenAPI 3.0 specification
- [API Lookup Endpoint](/api/lookup): REST endpoint to lookup WKD keys (GET with `email` parameter)

## Usage Examples

- [Main Lookup Interface](/): Web interface for looking up WKD keys by e-mail address
- [Advanced Method Documentation](https://datatracker.ietf.org/doc/draft-koch-openpgp-webkey-service/): Official IETF draft specification for WKD protocol

## Technical Details

The service implements the WKD lookup process:
1. Normalizes the local-part of e-mail address to lowercase
2. Hashes using SHA-1 algorithm
3. Encodes with Z-Base-32 to produce a 32-character string
4. Attempts Advanced Method first (openpgpkey subdomain)
5. Falls back to Direct Method if needed

The API returns comprehensive JSON responses including key metadata, validation results, randomart, and any errors encountered during the lookup process.

## Optional

- [Source Code](https://github.com/chimbosonic/wkd-tester): Complete project source code on GitHub