Skip to content

Commit

Permalink
chore: format
Browse files Browse the repository at this point in the history
  • Loading branch information
HenryQW committed Jan 30, 2024
1 parent 92fc198 commit a42a1e7
Show file tree
Hide file tree
Showing 2 changed files with 63 additions and 3 deletions.
7 changes: 4 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,10 @@ REP stands for RSS3 Evolution Proposal, a detailed documentation proposed by the

This repository tracks all REPs proposed by the RSS3 Community.

| REP Number | Title | Proposer(s) | Type | Status |
| ------------------------ | ---------------------- | --------------- | ------- | ------ |
| [REP-1](./REPs/REP-1.md) | Purpose and Guidelines | <[email protected]> | Process | Living |
| REP Number | Title | Proposer(s) | Type | Status |
| -------------------------- | ---------------------- | --------------- | -------- | ------ |
| [REP-1](./REPs/REP-1.md) | Purpose and Guidelines | <[email protected]> | Process | Living |
| [REP-11](./REPs/REP-11.md) | Protocol Upgrade | <[email protected]> | Protocol | Draft |

## License

Expand Down
59 changes: 59 additions & 0 deletions REPs/REP-11.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
```
REP: REP-11
Title: Protocol Upgrade
Status: Draft
Type: Protocol
Created: 22 Jan 2024
Author(s): [email protected]
Description: This REP describes the process of upgrading the RSS3 Protocol v0.4.0-rc.1 to v1.0.0.
Discussions: <https://forum.rss3.io/t/rss3-protocol-upgrade/65>
```

# REP-11: RSS3 Protocol Upgrade

## Table of Contents

- [Abstract](#abstract)
- [Motivation](#motivation)
- [Specification](#specification)
- [Rationale](#rationale)

## Abstract

This REP proposes to upgrade the RSS3 Protocol, based on the RSS3 Unified Metadata Schemas.

## Motivation

The RSS3 Protocol v0.4.0-rc.1 was the last version released through community consensus.
Following this, the RSS3 Core Devs have been dedicating their efforts to the RSS3 Unified Metadata Schemas (UMS), which has been implemented as the structures for circulating Open Information on the RSS3 DSL > v0.4.

Upgrading the RSS3 Protocol with UMS means that the Protocol will see its first stable and production-grade version, and also align with ongoing advancements in the DSL.

## Specification

See [RSS3 Protocol v1.0.0](https://github.com/RSS3-Network/Protocol/blob/v1.0.0/versions/v1.0.0/main.adoc) for the full specification.

Note: the specification is a work in progress due to the complexity of the Protocol.

## Rationale

The RSS3 Protocol v0.4.0-rc.1 was a file-based solution for storing and circulating Open Information.
The approach was chosen to navigate the uncertainties of the Open Web at that time.
It was designed to be simple and easy to use, but it also had its limitations:

1. Scalability - it simply could not handle large amounts of data
2. Performance - the query speed was slow
3. Storage Cost - the storage cost was high
4. Interoperability - it was difficult for developers to build on top of the Protocol

The landscape of the Open Web has also changed a lot since the release of v0.4.0-rc.1, and the RSS3 Core Devs have been working on the RSS3 Unified Metadata Schemas (UMS) to align with the new trends.

The UMS is essentially a set of JSON schemas that define the structures of Open Information.
The storage of Open Information is no longer limited to files, but can be stored in any relational database, in this case, the RSS3 Core Devs have chosen to use CockroachDB.

The UMS addresses all the problems of the RSS3 Protocol v0.4.0-rc.1:

1. Scalability - the current DSL hosts 1.5b+ pieces of Open Information
2. Performance - the query speed is lightning fast
3. Storage Cost - the storage cost is much lower
4. Interoperability - it provides a set of APIs for developers to build on top of the Protocol

0 comments on commit a42a1e7

Please sign in to comment.