GENESIS Hub

This site holds the code for the Genesis Hub. It includes the core vision for the Genesis multicreator gaming universe, governance processes and procedures, the community improvement process, as well as key resources such as the roadmap.

GENESIS Community Improvement Proposals (CIPs)

Community Improvement Proposals (CIPs) describe standards for the Genesis platform, including core protocol specifications, client APIs, and contract standards.

Before you initiate a pull request, please read the CIP-1 process document. Ideas should be thoroughly discussed prior to opening a pull request, such as on the Genesis forums or in a GitHub issue in this repository.

This repository tracks the ongoing status of CIPs. It contains:

• Draft proposals which intend to complete the CIP review process.
• Last Call for proposals that may become final (see also RSS feed).
• Accepted proposals which are awaiting implementation or deployment by Genesis client developers.
• Final and Active proposals that are recorded.
• The CIP process that governs the CIP repository.

Achieving "Final" status in this repository only represents that a proposal has been reviewed for technical accuracy. It is solely the responsibility of the reader to decide whether a proposal will be useful to them.

Browse all current and draft CIPs on the official CIP site.

Once your first PR is merged, we have a bot that helps out by automatically merging PRs to draft CIPs. For this to work, it has to be able to tell that you own the draft being edited. Make sure that the 'author' line of your CIP contains either your GitHub username or your email address inside <triangular brackets>. If you use your email address, that address must be the one publicly shown on your GitHub profile.

Project Goal

The Community Improvement Proposals repository exists as a place to share concrete proposals with potential users of the proposal and the Genesis community at large.

Preferred Citation Format

The canonical URL for a CIP that has achieved draft status at any point is at https://hub.gamecredits.org/. For example, the canonical URL for CIP-1 is https://hub.gamecredits.org/cips/cip-1.

Please consider anything which is not published on https://hub.gamecredits.org/ as a working paper.

And please consider anything published at https://hub.gamecredits.org/ with a status of "draft" as an incomplete draft.

Validation

CIPs must pass some validation tests. The CIP repository ensures this by running tests using html-proofer and eip_validator.

It is possible to run the CIP validator locally:

gem install eip_validator
eip_validator <INPUT_FILES>

Automerger

The CIP repository contains an "auto merge" feature to ease the workload for CIP editors. If a change is made via a PR to a draft CIP, then the authors of the CIP can GitHub approve the change to have it auto-merged by the cip-automerger bot.

Local development

Prerequisites

1. Open Terminal.

2. Check whether you have Ruby 2.1.0 or higher installed:

$ ruby --version

3. If you don't have Ruby installed, install Ruby 2.1.0 or higher.

4. Install Bundler:

$ gem install bundler

5. Install dependencies:

$ bundle install

Build your local Jekyll site

1. Bundle assets and start the server:

$ bundle exec jekyll serve

2. Preview your local Jekyll site in your web browser at http://localhost:4000.

More information on Jekyll and GitHub pages here.

License

FIXME Determine the license type and put it here