From f84e22433a9dbee4d34a22a266e028e545bdd8fd Mon Sep 17 00:00:00 2001 From: Gab Virebent Date: Sat, 22 Aug 2026 20:36:56 +0200 Subject: Initial identicons-web release --- README.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) create mode 100644 README.md (limited to 'README.md') diff --git a/README.md b/README.md new file mode 100644 index 0000000..1470ba7 --- /dev/null +++ b/README.md @@ -0,0 +1,26 @@ +# identicons-web + +VFace identity generator and verifier for the Virebent web service. + +The project contains: + +- `index.php`, the PHP verifier and identity page generator; +- `identicons-cli.go`, a dependency-free Go CLI implementing the + Ch1ffr3punk identicon rendering used by VFace and Aegis. + +## Build the CLI + +```sh +go build -buildvcs=false -o identicons-cli . +``` + +The PHP application expects the compiled `identicons-cli` beside `index.php` +and requires PHP sodium support. Deploy the directory behind a PHP-capable web +server. Do not make uploaded files executable or writable by the web process. + +## VFace input + +The deterministic identity input is `username|email|canonical-ed25519-public-key`. +The service publishes verification data and PNG hashes, but private keys must +remain on the user's device and must never be uploaded or committed. + -- cgit v1.2.3