1
0
mirror of https://github.com/oceanprotocol/status synced 2024-11-25 03:20:15 +01:00
status/README.md
2019-12-12 21:23:27 +00:00

4.3 KiB

banner

status

🐚 Overview and status checks of all Ocean Protocol RPC network connections. https://status.oceanprotocol.com

Build Status Maintainability Test Coverage Greenkeeper badge

Status Interface

🦑 Features

  • Fetches and displays information for each of Ocean's remote RPC endpoints via Parity JSON-RPC API responses
    • online/offline status (eth_getBlockByNumber & parity_mode)
    • current block number (eth_getBlockByNumber)
    • response time (custom axios interceptor)
    • connected peers (net_peerCount)
    • gas limit (eth_getBlockByNumber)
    • gas price (eth_gasPrice)
    • parity version (web3_clientVersion)
  • current block number is linked to respective explorer
  • automatically refetches all data every 5 sec.
  • Gets network metadata from @ethereum-navigator/atlas

🏄 Get Started

The app is a React app built with Next.js. To start local development:

git clone git@github.com:oceanprotocol/status.git
cd status

npm install
npm start

Code Style

For linting and auto-formatting you can use from the root of the project:

# lint all js with eslint
npm run lint

# auto format all js & css with prettier, taking all configs into account
npm run format

👩‍🔬 Testing

Test suite is setup with Jest and react-testing-library for unit testing.

To run all linting and unit tests:

npm test

For local development, you can start the test runner in a watch mode.

npm run test:watch

For analyzing the generated JavaScript bundle sizes you can use:

npm run analyze

🛳 Production

To create a production build, run from the root of the project:

npm run build
# serve production build
npm run serve

Outputs to ./public.

⬆️ Deployment

Every branch or Pull Request is automatically deployed by Now with their GitHub integration. A link to a deployment will appear under each Pull Request.

The latest deployment of the master branch is automatically aliased to status.oceanprotocol.com.

Manual Deployment

If needed, app can be deployed manually. Make sure to switch to Ocean Protocol org before deploying:

# first run
now login
now switch

# deploy
now
# switch alias to new deployment
now alias

🎁 Contributing

See the page titled "Ways to Contribute" in the Ocean Protocol documentation.

🏛 License

Copyright 2019 Ocean Protocol Foundation Ltd.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.