Hyperledger Fabric Samples

You can use Fabric samples to get started working with Hyperledger Fabric, explore important Fabric features, and learn how to build applications that can interact with blockchain networks using the Fabric SDKs. To learn more about Hyperledger Fabric, visit the Fabric documentation.

Getting started with the Fabric samples

To use the Fabric samples, you need to download the Fabric Docker images and the Fabric CLI tools. First, make sure that you have installed all of the Fabric prerequisites. You can then follow the instructions to Install the Fabric Samples, Binaries, and Docker Images in the Fabric documentation. In addition to downloading the Fabric images and tool binaries, the instructions will make you clone the Fabric samples on your local machine.

Guide to the Fabric samples

You can use the following table to learn more about each sample, and find the corresponding tutorial or documentation.

Sample	Description	Documentation
Fabric test network	Get started by deploying a basic Fabric network on your local machine.	Using the Fabric test network
Commercial paper	Explore a use case in which two organizations use a blockchain network to trade commercial paper.	Commercial paper tutorial
Interest rate swaps	Explore state based endorsement using a financial services use case.	Setting Key level endorsement policies
Off chain data	Learn how to use the Peer channel-based event services to build an off chain database for reporting and analytics.	Peer channel-based event services
High throughput	Learn how you can design your smart contracts to process a large volume of transactions.
Chaincode	A set of sample smart contracts used by other samples and the tutorials in the Fabric documentation.	Fabric tutorials
Fabcar	Deprecated in favor of basic asset transfer sample

Asset transfer smart contract series

The asset transfer series provides a series of smart contracts and applications that you can use to create and transfer a generic asset using Hyperledger Fabric. However, each sample is built with different smart contract and application APIs in order to demonstrate different Fabric features. The Basic sample provides an introduction on how to write smart contracts and how to interact with a Fabric network using the Fabric SDKs. The Secured agreement sample demonstrates how to use more advanced capabilities to develop a more realistic transfer scenario.

Smart Contract	Description	Tutorial	Smart contract languages	Application languages
Basic	The Basic sample smart contract that allows you to create and transfer an asset by putting data on the ledger and retrieving it. This sample is recommended for new Fabric users.	Writing your first application	Go, JavaScript, Typescript, Java	JavaScript, Java
Ledger queries	The ledger queries sample demonstrates how to deploy an index with your chaincode and issue rich queries when you are using CouchDB as your state database.	Coming soon	Go, JavaScript	Java
Private data	This sample demonstrates the use of private data collections and how the private data hash can be used to verify an agreement before executing a transfer	Coming soon	Go	JavaScript
State-Based Endorsement	This sample demonstrates the use of state-based endorsements and how the default chaincode endorsement policy can be modified for a specified Key	Coming soon	Go, JavaScript, Java	Coming soon
Secured agreement	Smart contract that uses private data, state based endorsement, and access control to establish the ownership of an asset, guarantee immutability, and securely transfer an asset with the consent of both the buyer and the owner, while keeping the asset details private.	Secured asset transfer in Fabric	Go	Coming soon

The asset transfer series is still a work in progress. Additional smart contract and application languages are being developed. The series will also be integrated with other Fabric samples and the documentation in the near future. For more information, see the public plan for Fabric samples improvements.

License

Hyperledger Project source code files are made available under the Apache License, Version 2.0 (Apache-2.0), located in the 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/.