feat: add keygen command and inject docker build metadata

1 files changed, 35 insertions, 0 deletions

diff --git a/README.md b/README.md
index 2270aa7..7010dbb 100644
--- a/README.md
+++ b/README.md
@@ -33,6 +33,40 @@ task verify:small
 task bench
 ```
 
+## Dev / Smoke Test (Docker Compose)
+
+```bash
+VERSION="$(cat VERSION)" \
+COMMIT="$(git rev-parse --short HEAD)" \
+BUILD_DATE="$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
+docker compose -f docker-compose.yml -f docker-compose.dev.yml up --build
+```
+
+Compose build args are read from environment variables (`VERSION`, `COMMIT`, `BUILD_DATE`).
+Equivalent direct build:
+
+```bash
+docker build \
+  --build-arg VERSION="$(cat VERSION)" \
+  --build-arg COMMIT="$(git rev-parse --short HEAD)" \
+  --build-arg BUILD_DATE="$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
+  -t plutia:local .
+```
+
+In a second terminal, generate the mirror signing key inside the running container:
+
+```bash
+docker compose -f docker-compose.yml -f docker-compose.dev.yml exec plutia /app/plutia keygen --out=/var/lib/plutia/mirror.key
+```
+
+Verify checkpoint and proof endpoints:
+
+```bash
+curl -sS http://127.0.0.1:8080/checkpoints/latest | jq .
+DID="$(curl -sS 'http://127.0.0.1:8080/export?count=1' | head -n 1 | jq -r '.did')"
+curl -sS "http://127.0.0.1:8080/did/${DID}/proof" | jq .
+```
+
 ### CLI Commands
 
 ```bash
@@ -42,6 +76,7 @@ plutia verify --config=config.default.yaml --did=did:plc:example
 plutia snapshot --config=config.default.yaml
 plutia bench --config=config.default.yaml --max-ops=200000
 plutia compare --config=config.default.yaml --remote=https://mirror.example.com
+plutia keygen --out=./mirror.key [--force]
 plutia version
 ```