🕸️ LIBYS Protocol

LIBYS is a protocol for creating a verifiable interaction history from delegated, signed events, allowing independent observers to derive trust and reputation from the resulting graph.

💡 Overview

LIBYS is an experimental protocol for representing identity, delegated authority and verifiable interactions as signed events.

Rather than defining how reputation should be calculated, LIBYS provides a common event model that allows independent observers to derive reputation from interaction history and graph topology.

The protocol is transport and storage agnostic. Events may be distributed through P2P networks, immutable databases or decentralized ledgers.

⚙️ How It Works

Every participant is identified by an Ed25519 key pair.

Interactions are represented as signed events.

At its simplest form:

(identity) --[signed event]--> (subject)

Authority can be delegated without sharing private keys:

(identity A) --[system.auth.grant]--> (identity B)
(identity B) --[delegated event]--> (subject)

Delegation is temporary and scoped to specific event types, allowing applications, services or users to act on behalf of another identity without exposing long-lived credentials.

The protocol makes no distinction between users, applications or autonomous agents. Every participant is simply another cryptographic identity.

🔍 Reputation

LIBYS intentionally does not define a reputation algorithm.

Different observers may analyze the same interaction graph using different models depending on their own requirements. Reputation may consider factors such as:

• interaction history
• delegation chains
• graph connectivity
• temporal weighting
• cluster detection

The protocol standardizes verifiable events, not their interpretation.

🧩 Potential Applications

Applications that can be built on top of LIBYS include:

• portable reputation systems
• decentralized marketplaces
• delegated machine-to-machine authorization
• DAO governance
• federated social platforms
• autonomous agent trust networks

📄 Whitepaper

The complete protocol specification is available in WHITEPAPER.pdf.

📦 Proof of Concept

This repository includes a minimal Java implementation demonstrating:

• Ed25519 identity generation
• event creation and signing
• delegated authority
• signature verification

Prerequisites

• Java 17+
• Maven
• jq
• xxd

Running the Demo

chmod +x poc/demo.sh
./poc/demo.sh

Manual Testing

You can also interact with the CLI directly. Detailed command examples are available in poc/NOTES.md.

⭐ Support the Project

If you find this project interesting, consider giving the repository a star.

📄 License

Distributed under the MIT License. See LICENSE for more information.