algovoi-keystone-grpc 0.1.3

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)

algovoi-keystone-grpc

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

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.