KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #typescript #developer-tools #claude-code #ai-agent #codex #deepseek-harness #ai-agents #cli #react #mcp

atlas-protocol

★ 9 Open GitHub ↗

Atlas is a transport-protcol-agnostic P2P decentralized publishing and discovery protocol where users own their data and govern it to converge into structured, interoperable databases, empowering users and developers.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Atlas — Your data, your rules
[See code repository on gitlab](https://gitlab.com/radarsu/atlas/-/tree/main/docs)

## Table of contents

| Document | Description |
|----------|-------------|
| [AUTH](protocol/AUTH.md) | Authentication |
| [GOVERNANCE](protocol/GOVERNANCE.md) | Governance |
| [KEYS](protocol/KEYS.md) | Key format and tiers |
| [PREFERENCES](protocol/PREFERENCES.md) | Preferences |
| [REST](protocol/REST.md) | REST API |
| [SECURITY](protocol/SECURITY.md) | Security |
| [FAQ](explanations/FAQ.md) | Frequently asked questions |
| [NOSTR](explanations/NOSTR.md) | Nostr differences |
| [TYPES-OF-APPS](explanations/TYPES-OF-APPS.md) | Types of applications |
| [MANIFEST](explanations/MANIFEST.md) | Manifest |
| [Order Overview](order/README.md) | Atlas Order overview |
| [Order Economy](order/ECONOMY.md) | Order economic model |
| [Order Verification](order/VERIFICATION.md) | Order identity verification |

## Overview

Atlas is a transport-protocol-agnostic P2P decentralized publishing and discovery protocol where **users own their data** and **govern it to converge into structured, interoperable databases**, empowering users and developers.

The system separates 5 elements:

- **Identity** - cryptographic private key.
- **Content** - identified by hash, signed by author, and possibly readable only by targeted audience.
- **Storage** - distributed databases (best-effort caches) for standardized formats.
- **Semantics** - governed by open contribution processes (Schema.org).
- **Gossip** - knowledge of other Nodes.

## Atlas-compliant systems MUST be:

- **Open** - Allow configuration of Nodes to pull data from, all data MUST be public and exportable.
- **Fair** - Communicate with all Nodes equally, in accordance with their transparent local policy.
- **Resilient** — Nodes MUST reject unverified or anonymous traffic to protect the network's collective resources and maintain high-signal discovery.

## Atlas-compliant systems SHOULD be:

- **Semantic** - Built on top of structured data formats, allowing interoperable, distributed databases to emerge in the ecosystem, preserving user's ownership over his data.
- **Gossiping** - Share and aggregate knowledge about known Nodes and their metadata to improve network discoverability.

## Core Concepts

### User

Person controlling a cryptographic private key.

- Creates, signs, and publishes Envelopes (data).
- Chooses which Nodes to publish to and which Nodes to read from.

### Connectors

Stateless servers that allow Nodes to connect when they don't have means for direct discoverability and connection, for example:

- WebRTC offer/answer exchanges.
- WebSocket servers.

### Node

Each user may turn into a Node and start hosting data in P2P network by enabling any subset of features:

**Storage**

- Pull data from known Nodes to achieve desired state.
- Accept queries to its database.
- Accept subscriptions to notifications about Envelopes.
- Accept Envelopes from users.

**Gossip**

- Share knowledge about own metadata.
- Share knowledge about known Nodes and their metadata (description, supported endpoints, data types, data hashes, public key to claimed name mappings).

### Envelope

Signed, immutable unit of data with a strictly defined structure.

- "Payment" Envelopes may contain proof of payment verifiable by Nodes with Lightning integration (convention).

atlas-protocol

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README