Skip to content

Commit

Permalink
Merge pull request #692 from aklenik/fisco-readme-fix
Browse files Browse the repository at this point in the history
Add readme for FISCO adapter
  • Loading branch information
nklincoln authored Jan 8, 2020
2 parents 06641ab + 881bf4a commit a1dcfde
Show file tree
Hide file tree
Showing 2 changed files with 57 additions and 0 deletions.
56 changes: 56 additions & 0 deletions packages/caliper-fisco-bcos/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
# ![Hyperledger Caliper](https://wiki.hyperledger.org/download/attachments/2392434/Hyperledger_Caliper_Logo_Color.svg?version=1&modificationDate=1548883186000&api=v2)

[![Build Status](https://travis-ci.org/hyperledger/caliper.svg?branch=master)](https://travis-ci.org/hyperledger/caliper)
[![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/2381/badge)](https://bestpractices.coreinfrastructure.org/projects/2381)
[![license](https://img.shields.io/badge/license-Apache%202.0-blue)](https://github.com/aklenik/caliper/blob/master/LICENSE)
[![node (scoped)](https://img.shields.io/node/v/@hyperledger/caliper-cli)](https://www.npmjs.com/package/@hyperledger/caliper-cli)
[![npm (scoped)](https://img.shields.io/npm/v/@hyperledger/caliper-cli?label=version)](https://www.npmjs.com/package/@hyperledger/caliper-cli)
[![npm](https://img.shields.io/npm/dt/@hyperledger/caliper-cli?label=npm%20downloads)](https://www.npmjs.com/package/@hyperledger/caliper-cli)
[![Docker Pulls](https://img.shields.io/docker/pulls/hyperledger/caliper)](https://hub.docker.com/r/hyperledger/caliper)
[![Rocket.Chat](https://img.shields.io/badge/rocket.chat-caliper-red)](https://chat.hyperledger.org/channel/caliper)
[![Mailing list](https://img.shields.io/badge/mailing%20list-caliper-blue)](https://lists.hyperledger.org/g/caliper/topics)

Welcome to the Hyperledger Caliper project. Caliper is a blockchain performance benchmark framework, which allows users to test different blockchain solutions with predefined use cases, and get a set of performance test results.

Currently supported blockchain solutions:

* [Hyperledger Fabric v1.X](https://github.com/hyperledger/fabric)
* [Hyperledger Sawtooth 1.0+](https://github.com/hyperledger/sawtooth-core)
* [Hyperledger Iroha 1.0 beta-3](https://github.com/hyperledger/iroha)
* [Hyperledger Burrow 1.0](https://github.com/hyperledger/burrow)
* [Ethereum](https://github.com/ethereum/go-ethereum)
* [Hyperledger Besu](https://github.com/hyperledger/besu), utilizing the Ethereum adapter.
* [FISCO BCOS](https://github.com/FISCO-BCOS/FISCO-BCOS)

Currently supported performance indicators:
* Success rate
* Transaction/Read throughput
* Transaction/Read latency (minimum, maximum, average)
* Resource consumption (CPU, Memory, Network IO, ...)

See the [PSWG white paper](https://www.hyperledger.org/resources/publications/blockchain-performance-metrics) to find out the definitions and corresponding measurement methods.

For more information on using Caliper, please consult the [documentation site](https://hyperledger.github.io/caliper/)

## Install and usage
See the [related documentation page](https://hyperledger.github.io/caliper/vLatest/installing-caliper/).

## How to contact us

If you have any issues using Caliper that the documentation does not help you solve, please reach out to us through the following methods:
* [RocketChat](https://chat.hyperledger.org/channel/caliper) Please feel free to contact us on Rocket Chat (instant messaging). We monitor that channel as close as possible, but even if you don't have a problem that needs resolving, why not jump on and say hi ... we'd love to hear from you about your experiences and any new features you think we should work on.
* [Issues](https://github.com/hyperledger/caliper/issues) Feel free to raise an issue if you are facing a Caliper related problem

Caliper interacts with multiple blockchain technologies and consequently it *might* be an issue with the underlying blockchain technology being interacted with. You can seek specific help on these technologies within the following Rocket Chat channels:
* [Hyperledger Besu](https://chat.hyperledger.org/channel/besu)
* [Hyperledger Burrow](https://chat.hyperledger.org/channel/burrow)
* [Hyperledger Fabric](https://chat.hyperledger.org/channel/fabric)
* [Hyperledger Iroha](https://chat.hyperledger.org/channel/iroha)
* [Hyperledger Sawtooth](https://chat.hyperledger.org/channel/sawtooth)

## How to contribute

We welcome contributions to the Caliper code base. Please see [Contributing](/CONTRIBUTING.md) for more information.

## License
Hyperledger Project source code files are made available under the Apache License, Version 2.0 (Apache-2.0), located in the [LICENSE](LICENSE) file. Hyperledger Project documentation files are made available under the Creative Commons Attribution 4.0 International License (CC-BY-4.0), available at http://creativecommons.org/licenses/by/4.0/.
1 change: 1 addition & 0 deletions packages/caliper-fisco-bcos/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -52,6 +52,7 @@
"file_type_method": "EXCLUDE",
"file_types": [
".yml",
".md",
".log"
],
"insert_license": false,
Expand Down

0 comments on commit a1dcfde

Please sign in to comment.