Giter Club home page Giter Club logo

eth2.0-apis's Introduction

Ethereum 2.0 APIs

CI

Collection of RESTful APIs provided by Ethereum 2.0 clients

API browser: https://ethereum.github.io/eth2.0-APIs/

Outline

This document outlines an application programming interface (API) which is exposed by a beacon node implementation which aims to facilitate Phase 0 of Ethereum 2.0.

The API is a REST interface, accessed via HTTP, designed for use as a public communications protocol. Currently, the only supported return data type is JSON.

The beacon node (BN) maintains the state of the beacon chain by communicating with other beacon nodes in the Ethereum 2.0 network. Conceptually, it does not maintain keypairs that participate with the beacon chain.

The validator client (VC) is a conceptually separate entity which utilizes private keys to perform validator related tasks, called "duties", on the beacon chain. These duties include the production of beacon blocks and signing of attestations.

The goal of this specification is to promote interoperability between various beacon node implementations.

Render

To render spec in browser you will need any http server to load index.html file in root of the repo.

Python
python -m SimpleHTTPServer 8080

And api spec will render on http://localhost:8080.

NodeJs
npm install simplehttpserver -g

# OR

yarn global add simplehttpserver

simplehttpserver

And api spec will render on http://localhost:8000.

Contributing

Api spec is checked for lint errors before merge.

To run lint locally, install linter with

npm install -g @stoplight/spectral

# OR

yarn global add @stoplight/spectral

and run lint with

spectral lint beacon-node-oapi.yaml 

Implementations

https://www.npmjs.com/package/@chainsafe/eth2.0-api-wrapper

Releasing

  1. Create and push tag

    • Make sure info.version in beacon-node-oapi.yaml file is updated before tagging.
    • CD will create github release and upload bundled spec file
  2. Add release entrypoint in index.html

In SwaggerUIBundle configuration (inside index.html file), add another entry in "urls" field (SwaggerUI will load first item as default). Entry should be in following format(replace <tag> with real tag name from step 1.):

         {url: "https://cors-anywhere.herokuapp.com/https://github.com/ethereum/eth2.0-APIs/releases/download/<tag>/beacon-node-oapi.yaml", name: "<tag>"},

eth2.0-apis's People

Contributors

0xkiwi avatar decanus avatar djrtwo avatar gregthegreek avatar hwwhww avatar magicking avatar mpetrunic avatar paulhauner avatar skmgoldin avatar snario avatar spble avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.