Research Implementation · v1.0.1

LICITRA
Execution Gateway

Cryptographic execution integrity for AI agents.

Every action authorized. Every deviation blocked. Every event tamper-evident.

✓ 91 Tests Passing OWASP LLM01 · LLM05 · LLM06 · LLM10 MIT License
View on GitHub Read the Research

Authorization is not enough.

Current AI security tools answer whether an agent is allowed. LICITRA answers whether the action that executed matched what was approved.

Current AI Security

Most tools answer: "Is this agent allowed to do this?"

Authorization checks pass. The agent proceeds. Nothing verifies that what executes matches what was approved.

What LICITRA Answers

"Did the action that actually executed match — byte for byte — what was approved?"

Cryptographic proof. Tamper-evident audit chain. Third-party verifiable inclusion proof.

Five gates before any action executes.

Every agent action passes through the complete pipeline. No bypass. Every decision written to the MMR audit chain.

01

Intent Scan

LLM01 injection scanner. 8 patterns, HIGH/MEDIUM severity. INJ001–INJ008.

02

Policy Check

Rate limits, daily budget, allowed actions and resources. SELECT FOR UPDATE.

03

Signed Ticket

Ed25519 signed. SHA-256 payload hash bound. JTI for replay prevention.

04

12 Checks

Signature, expiry, replay, payload hash, action, resource, schema, injection rescan.

05

MMR Audit

Tamper-evident append. O(log N) inclusion proof. mmr_detect_tampering() on every read.

Primary coverage for four risks.

Every claim is verifiable directly from the codebase. No broad coverage claims that cannot be substantiated.

LLM01

Prompt Injection

8 patterns scanned at intent creation and re-scanned at execution. INJ001–INJ008, HIGH/MEDIUM severity.

PRIMARY COVERAGE
LLM05

Improper Output Handling

JSON Schema validation at Check 9. additionalProperties enforced. Schema declared at agent registration.

PRIMARY COVERAGE
LLM06

Excessive Agency

12-check cryptographic verification pipeline. Exact action, resource, and payload hash binding per ticket.

PRIMARY — CORE
LLM10

Unbounded Consumption

Per-agent hourly and daily action limits. Daily budget caps. Race condition safe with SELECT FOR UPDATE.

PRIMARY COVERAGE

Running in under five minutes.

Docker Desktop and Git are the only prerequisites. No local Python setup required.

terminal
git clone https://github.com/narendrakumarnutalapati/licitra-execution-gateway
cd licitra-execution-gateway
cp .env.example .env
make up      # starts API + React dashboard + PostgreSQL
make seed    # populates with 46 realistic events
# Open http://localhost:5173

Ten attack scenarios. Run from the browser.

Each demo runs the full pipeline and returns the blocking reason, verification diff, evidence ID, and millisecond timing.

Tampered Payload

BLOCKED

Check 8 · Payload hash mismatch

Replay Attack

BLOCKED

Check 5 · JTI already consumed

Prompt Injection

BLOCKED

Intent scanner · INJ pattern matched

Schema Violation

BLOCKED

Check 9 · Output schema invalid

Rate Limit Exceeded

BLOCKED

Policy layer · Hourly limit exceeded

MMR Audit Tamper

DETECTED

mmr_detect_tampering() · Root hash mismatch

Over-scoped Action

BLOCKED

Check 11 · Agent scope exceeded

Expired Ticket

BLOCKED

Check 4 · Ticket expiry exceeded

Fake Agent

BLOCKED

Check 1 · Agent not registered

Delegation Escalation

NOT YET IMPLEMENTED

v1.2 roadmap · Check 13

Grounded in published research.

This gateway is the reference implementation of the LICITRA research series, published on Zenodo and credited in OWASP GenAI Data Security Risks v1.0.

📄

LICITRA-SENTRY v0.2

Execution tickets and witnessed transparency for runtime enforcement. Five-gate Chain of Intent authorization pipeline. Ed25519 signed tickets with JTI replay protection.

doi.org/10.5281/zenodo.18860290
🔗

LICITRA-MMR-CORE v0.2

Merkle Mountain Range audit ledger for tamper-evident accountability. O(log N) inclusion proofs. Position-binding leaf hashes preventing swap attacks.

doi.org/10.5281/zenodo.18843032
⚙️

Gateway v1.0.1

Reference implementation. 91 tests. FastAPI + PostgreSQL + React. Docker Compose. Full Ed25519 ticket lifecycle, 12-check verifier, MMR audit chain, PDF evidence generation.

doi.org/10.5281/zenodo.20634496