eep-gates 0.1.0

EEP Gates — Access control, commerce, and service discovery for the Entity Engagement Protocol

eep-gates (Python)

Python port of @eep-dev/gates — access control, commerce negotiation, and service discovery for the Entity Engagement Protocol.

Install

pip install -e .

Usage

from eep_gates import (
    parse_gate_config,
    resolve_access,
    build_402_response,
    ProofVerifier,
    ProofVerifierRegistry,
)

# Parse gate config
config = parse_gate_config({
    "default_tier": "public",
    "tiers": {
        "public": {"requirements": [], "access": ["events.*"]},
        "premium": {
            "requirements": [{"type": "payment", "amount": 10, "currency": "usd", "per": "month"}],
            "access": ["*"],
        },
    },
})

# Resolve access
class PaymentVerifier(ProofVerifier):
    @property
    def supported_types(self):
        return ["payment"]

    async def verify(self, proof, requirement):
        return proof.get("type") == "payment" and bool(proof.get("token"))


registry = ProofVerifierRegistry()
registry.register(PaymentVerifier())
result = await resolve_access(proofs, config, "content.papers", verifier_registry=registry)

if not result.granted:
    resp = await build_402_response(config, "content.papers", proofs)
    return JSONResponse(resp, status_code=402)

Modules

Module	Description
models	Pydantic data models (requirements, proofs, tiers, commerce)
gate_config	Parse, validate, and serialize gate configurations
resource_matcher	Wildcard pattern matching for access control
access_resolver	Determine tier access from proofs
proof_validator	Structural validation + verifier registry
http_402	Build spec-compliant 402 responses
commerce	Negotiation state machine + pricing validation
service_listing	Service catalog and review validation

Tests

pip install -e ".[dev]"
pytest

License

Apache-2.0