Metadata-Version: 2.4
Name: interop-verifier
Version: 1.0.0
Summary: Generalized Sally-style KERIpy verifier for ACDC interop tests
Project-URL: Homepage, https://github.com/kentbull/interop-verifier
Project-URL: Repository, https://github.com/kentbull/interop-verifier
Project-URL: Issues, https://github.com/kentbull/interop-verifier/issues
Author-email: Kent Bull <kent@kentbull.com>
Keywords: acdc,cesr,ipex,keri,verifier
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Security :: Cryptography
Requires-Python: >=3.12.6
Requires-Dist: falcon==4.0.2
Requires-Dist: hio<0.7.0,>=0.6.14
Requires-Dist: http-sfv==0.9.9
Requires-Dist: keri<1.3.0,>=1.2.12
Description-Content-Type: text/markdown

# interop-verifier

`interop-verifier` is a generalized Sally-style KERIpy verifier used by the
`keri-ts` ACDC interop tests. It receives normal CESR/IPEX credential
presentations, verifies them with KERIpy VDR state, and posts generic webhook
payloads without hardcoding the vLEI credential chain.

## Install

```sh
uv tool install interop-verifier
```

## Run from PyPI

```sh
interop-verifier start \
  --name verifier \
  --base "" \
  --alias verifier \
  --http 9723 \
  --web-hook http://127.0.0.1:9923/
```

The verifier uses a bundled no-witness inception config by default. Pass
`--incept-file` to use a custom KERIpy-style inception JSON file.

## Run with Docker

```sh
docker run --rm -p 9723:9723 kentbull/interop-verifier:1.0.0 start \
  --name verifier \
  --head-dir /data \
  --alias verifier \
  --http 9723 \
  --web-hook http://host.docker.internal:9923/
```

Mount `/data` to persist verifier key state.

## Interfaces

The verifier serves:

- `GET /health` for liveness and queue counts.
- `GET /oobi/{aid}/controller` for KERI controller OOBI resolution.
- `PUT /` and `POST /` for CESR/KERI ingress.
- Sally-style signed webhook callbacks for verified credentials.

## Development

```sh
make sync
make check
make build
make docker-build
```
