@nekzus/liop
Nekzus/LIOP
Official SDK for Logic-Injection-on-Origin Protocol (LIOP). Deploy Logic-on-Origin with WebAssembly at gRPC speed and bidirectional MCP compatibility.
Instalação
npx convez-ai Nekzus/LIOP1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
Logic-Injection-on-Origin Protocol (LIOP)
LIOP is a next-generation, high-performance binary transport mesh designed for advanced AI Agent communication. It is the conceptual and technical evolution of the Model Context Protocol (MCP), radically shifting the paradigm from pulling massive data to secure Logic-Injection-on-Origin (LIO) execution.
Instead of moving terabytes of data to the AI, LIOP moves lightweight, sandboxed logic to the data.
The Problem
In the rapid evolution of autonomous agents, transferring gigabytes of raw data to central AI nodes for filtering, parsing, or reasoning is increasingly inefficient, slow, and expensive. Current protocols force agents to download entire datasets to extract a few relevant insights, wasting bandwidth, tokens, and time.
The LIOP Solution: Logic-Injection-on-Origin
LIOP introduces a decentralized, Zero-Trust architectural model where AI agents inject ultra-lightweight, sandboxed execution modules (WebAssembly) directly into the data source. The data never leaves its origin.
@LIOP{wasi_v1,AuditModule}
...
@END
Key benefits:
- Dramatically reduces network latency and bandwidth — only semantically relevant results are returned.
- Saves millions of tokens — agents receive cryptographically verified evidence, not raw data.
- Zero-Trust by default — injected logic runs inside strict WASI sandboxes with capability-limited access.
Repository Structure
This is a polyglot monorepo organized into clear, isolated modules:
LIOP-Protocol/ (LIOP)
├── sdks/
│ ├── typescript/ # @nekzus/liop (NPM package)
│ └── rust/ # liop-core & liop-client (Cargo crates)
├── servers/
│ └── liop-node/ # liop-server (Wasmtime + gRPC + libp2p)
├── protocol/
│ ├── proto/ # Protobuf v3 service definitions (liop_core.proto)
│ └── SPECIFICATION.md # Formal protocol specification
├── examples/
│ ├── demos/ # High-fidelity & educational demos
│ └── wasm-filters/ # Example WASM payloads (filter, watchdog)
├── tools/
│ └── liop-cli/ # Developer CLI for Health/Negotiate checks
├── docs/ # Mintlify documentation portal
├── tests/ # E2E integration tests
├── MANIFESTO.md # Project philosophy & vision
├── CONTRIBUTING.md # Contribution guide (EN/ES)
├── CODE_OF_CONDUCT.md # Code of conduct (EN/ES)
└── Cargo.toml # Rust workspace root
Core Components
1. TypeScript SDK — sdks/typescript/
The developer-facing SDK, published as @nekzus/liop on NPM. Designed as a drop-in replacement for MCP with native LIOP capabilities.
| Feature | Description |
|---|---|
LiopServer | Register tools, resources, and prompts with Zod schema validation |
LiopClient | Discover and invoke remote tools via P2P mesh |
LiopMcpBridge | JSON-RPC 2.0 adapter for legacy MCP clients (Claude Desktop, Cursor) |
| Guardian AST | Static analysis of WASM imports to prevent sandbox escapes |
| PII Shield | Real-time detection and blocking of sensitive data via Customizable Regional Presets (Email, Credit Card, SSN, IBAN, Passport MRZ, custom regex) |
| Worker Pool | Multi-threaded execution via Piscina for non-blocking cryptography |
| PQC (Kyber) | Post-Quantum key encapsulation for transport layer security |
| Security | TLS/mTLS, Rate-Limiting, and QUIC transport support |
| Cross-AI Prompts | Zero-Shot Adaptors to train models in Real-Time (Claude XML, OpenAI, Gemini) |
| ZK Receipts | HMAC-SHA256 cryptographic proof of honest computation (ZK-VM roadmap) |
Read the TypeScript SDK Documentation
2. Rust SDK — sdks/rust/
The native Rust crates providing zero-overhead bindings to the LIOP mesh.
| Crate | Description |
|---|---|
liop-core | Shared Protobuf definitions compiled with tonic + prost |
liop-client | High-level agent interface with Kyber PQC, AES-256-GCM encryption, and Kademlia DHT discovery |
Read the Rust SDK Documentation
3. Mesh Node Server — servers/liop-node/
The high-performance Data Node host, written in Rust. This is where injected WASM logic executes.
| Module | Description |
|---|---|
executor.rs | Wasmtime + WASI sandbox with fuel-based CPU limits and liop::push_event host syscall |
guardian.rs | Zero-Time AST structural scanning via wasmparser — rejects malicious imports before JIT |
grpc.rs | Tonic gRPC server with PQC intent negotiation, Rate-Limiting, and streaming |
p2p.rs | libp2p Kademlia DHT for decentralized peer discovery over Noise/TCP/QUIC |
zk.rs | ZK-Receipt generation engine (HMAC-SHA256 commitments, ZK-VM roadmap) |
tee.rs | Trusted Execution Environment trait bounds for AWS Nitro Enclaves / Intel SGX |
config.rs / health.rs | TOML-driven configuration and Hyper-based observability (/health probes) |
Read the Mesh Node Documentation
Technical Stack
| Layer | Technology |
|---|---|
| Transport | Tonic gRPC + Protobuf v3 |
| Peer Discovery | libp2p (Kademlia DHT, Noise Protocol, QUIC) |
| Sandboxing | Wasmtime 29.0 + WASI Preview 1 |
| Post-Quantum Crypto | ML-KEM-768 (Kyber) + AES-256-GCM |
| Static Analysis | wasmparser AST inspection |
| Integrity Proofs | HMAC-SHA256 commitments (ZK-VM roadmap: RISC Zero / SP1) |
| TypeScript Runtime | Node.js ≥ 20 + Piscina Worker Threads |
| Code Quality | Biome.js (TS) + Clippy (Rust) |
| CI/CD | GitHub Actions + semantic-release + NPM Provenance |
Getting Started
Install the TypeScript SDK
npm install @nekzus/liop@latest
Run the Zero-Config Agent (CLI)
For end-users wanting to integrate with Claude Desktop instantly:
npx -y @nekzus/liop@latest
Build the Rust Backend
# Add WASI target
rustup target add wasm32-wasip1
# Compile the full workspace
cargo build
# Run tests
cargo test
Documentation
- Official Documentation Portal (Mintlify)
- Ask DeepWiki about LIOP
- Protocol Specification
- Project Manifesto
🤖 AI Agent Support
This project includes a native AGENTS.md file to provide optimized context and rules for AI-assisted development (Google Antigravity, Claude, Cursor). It ensures architectural alignment and security compliance during autonomous tasks.
Contributing
We welcome contributions! Please read our Contributing Guide for guidelines on how to get involved. This project adheres to a Code of Conduct.