Metadata-Version: 2.4
Name: algovoi-keystone-grpc
Version: 0.1.3
Summary: Bind gRPC unary calls to the AlgoVoi keystone -- a server interceptor gives every call a content-addressed execution_ref (keystone-only edition, Apache-2.0)
Author-email: AlgoVoi <chopmob@gmail.com>
License: Apache-2.0
Keywords: grpc,rpc,interceptor,microservices,keystone,execution_ref,jcs,rfc8785,algovoi
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: System :: Networking
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
Requires-Dist: algovoi-execution-ref>=0.1.0
Dynamic: license-file

# algovoi-keystone-grpc

[![Keystone Integration](https://img.shields.io/badge/Keystone-integration-7c8aa0)](https://docs.algovoi.co.uk/keystone)

Bind gRPC unary calls to the AlgoVoi keystone -- a server interceptor gives every call a content-addressed execution_ref. Open, keystone-only edition, Apache-2.0. Byte-compatible with `algovoi-execution-ref`.
Available on request -- see https://docs.algovoi.co.uk/keystone-connectors

```python
from algovoi_keystone_grpc import keystone_server_interceptor

server = grpc.server(executor, interceptors=[keystone_server_interceptor(on_execution=record)])
# each unary call carrying x-keystone-decision-ref metadata is bound to an execution_ref;
# the outcome is COMMITTED, or FAILED if the handler raises.
```

The `decision_ref` comes from call metadata (default `x-keystone-decision-ref`), a static value,
or a resolver callable. `keystone_unary_handler(...)` wraps a single behaviour with no gRPC
dependency; `rpc_execution_ref(...)` computes the ref standalone. Streaming handlers pass through
unbound.

A rejected or failed operation is recorded with outcome `SKIPPED` / `FAILED`; `tamper_detected(...)`
recomputes any binding offline.

## Keystone-only edition

The open edition binds and verifies each operation. The signed, hash-linked chain of operations
(PQC + CCC ingest) is the commercial tier.

## License

Apache-2.0. Copyright AlgoVoi.
