Note: This pattern focuses on older technology (e.g. Hyperledger Fabric APIs prior to Fabric 1.4). Therefore, there is no support for this pattern and it will be archived on May 1, 2019. You are welcome to use up to that date, but we recommend that you begin working with the updated release found at https://developer.ibm.com/patterns/monitor-food-shipments-using-blockchain/.
Food suppliers must comply with U.S. Food and Drug Administration (FDA) Foreign Supplier Verification Program regulatory requirements before they can ship their products to market. In this developer code pattern, you’ll learn how to use Hyperledger Composer to model food supplier verification regulatory requirements for a distributed business network.
Updated to support Hyperledger Fabric V1.1 and Hyperledger Composer V0.19.
Regulatory compliance is a high-focus area in which developers are looking to build applications that automate and standardize processes used to enforce and execute compliance. Blockchain presents an opportunity to do just that. You can use Hyperledger Composer to easily build a regulatory compliance application and build logic in a smart contract that is deployed on a business network. This pattern focuses on an FDA compliance use case. Get creative and apply it to your own use case of managing regulation compliance.
So in focusing on this use case, imagine that a supplier will transfer the food products to an importer who verifies that the supplier, country, and food type all match the correct identifiers. At the port of entry, the supplier is again checked against a list of known suppliers in a database (managed by the regulator). If the supplier is of type exempt, then products transfer to the retailer. If the supplier is non-exempt, the products are checked against a list of known food products in the database (managed by the regulator). If the food is an exempt product, then it transfers to the retailer. If the food is non-exempt, the importer must conduct the hazard analysis (either independently or by using a third party). The supplier provides the hazard analysis report to the regulator. The regulator reviews compliance and transfers the products to the retailer. In this pattern, we capture the regulatory compliance logic for the FDA Foreign Supplier Verification Program in a smart contract deployed on a business network.
This Hyperledger Composer pattern shows how to model food supplier verification regulatory requirements for a distributed business network. Keep in mind that a business network definition consists of model (.cto), script (.js), and ACL (.acl) files packaged and exported as an archive (.bna) file. The archive file is then deployed to a Hyperledger Fabric network.
- Install Hyperledger Composer development tools.
- Configure and start Hyperledger Fabric network.
- Generate the Business Network Archive file.
- Import the BNA file into Hyperledger Composer Playground.
Follow these steps to use Hyperledger Composer to model food supplier verification regulatory requirements for a distributed business network.
- Install the Hyperledger Composer Development Tools.
- Configure and start the Hyperledger Fabric network.
- Generate the Business Network Archive (BNA).
- Deploy the Business Network Archive using Composer Playground.
- Deploy the Business Network Archive on Hyperledger Composer running locally.