-
Notifications
You must be signed in to change notification settings - Fork 3.4k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
[FAB-15213] Update Commercial Paper for Java
Update with Java Contract Change-Id: I1a70473f038576d741c8c9ac83e527b5e51e88ca Signed-off-by: Matthew B. White <whitemat@uk.ibm.com> [FAB-15213] Update Commercial Paper for Java Change-Id: Ie116962a6c3952e52269323492f5f292e9b65e95 Signed-off-by: Matthew B. White <whitemat@uk.ibm.com>
- Loading branch information
Showing
81 changed files
with
8,143 additions
and
386 deletions.
There are no files selected for viewing
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,156 @@ | ||
# Commercial Paper Tutorial | ||
|
||
This folder contains the code for an introductory tutorial to Smart Contract development. It is based around the scenario of Commercial Paper. | ||
The full tutorial, including full scenario details and line by line code walkthroughs is in the [Hyperledger Fabric documentation](https://hyperledger-fabric.readthedocs.io/en/release-1.4/tutorial/commercial_paper.html). | ||
|
||
## Scenario | ||
|
||
In this tutorial two organizations, MagnetoCorp and DigiBank, trade commercial paper with each other using PaperNet, a Hyperledger Fabric blockchain network. | ||
|
||
Once you’ve set up a basic network, you’ll act as Isabella, an employee of MagnetoCorp, who will issue a commercial paper on its behalf. You’ll then switch hats to take the role of Balaji, an employee of DigiBank, who will buy this commercial paper, hold it for a period of time, and then redeem it with MagnetoCorp for a small profit. | ||
|
||
![](https://hyperledger-fabric.readthedocs.io/en/release-1.4/_images/commercial_paper.diagram.1.png) | ||
|
||
## Quick Start | ||
|
||
You are strongly advised to read the full tutorial to get information about the code and the scenario. Below are the quick start instructions for running the tutorial, but no details on the how or why it works. | ||
|
||
### Steps | ||
|
||
1) Start the Hyperledger Fabric infrastructure | ||
|
||
_although the scenario has two organizations, the 'basic' or 'developement' Fabric infrastructure will be used_ | ||
|
||
2) Install and Instantiate the Contracts | ||
|
||
3) Run client applications in the roles of MagnetoCorp and Digibank to trade the commecial paper | ||
|
||
- Issue the Paper as Magnetocorp | ||
- Buy the paper as DigiBank | ||
- Redeem the paper as DigiBank | ||
|
||
## Setup | ||
|
||
You will need a a machine with the following | ||
|
||
- Docker and docker-compose installed | ||
- Node.js v8 if you want to run Javascript client applications | ||
- Java v8 if you want to run Java client applications | ||
- Maven to build the Java applications | ||
|
||
It is advised to have 3 console windows open; one to monitor the infrastructure and one each for MagnetoCorp and DigiBank | ||
|
||
If you haven't already clone the repository to a directory of your choice, and change to the `commercial-paper` directory | ||
|
||
``` | ||
git clone https://github.com/hyperledger/fabric-samples.git | ||
cd fabric-samples/commercial-paper | ||
``` | ||
|
||
This `README.md` file is in the the `commercial-paper` directory, the source code for client applications and the contracts ins in the `ogranization` directory, and some helper scripts are in the `roles` directory. | ||
|
||
## Running the Infrastructure | ||
|
||
In one console window, run the `./roles/network-starter.sh` script; this will start the basic infrastructure and also start monitoring all the docker containers. | ||
|
||
You can cancel this if you wish to reuse the terminal, but it's best left open. | ||
|
||
### Install and Instantiate the contract | ||
|
||
The contract code is available as either JavaScript or Java. You can use either one, and the choice of contract language does not affect the choice of client langauge. | ||
|
||
In your 'MagnetoCorp' window run the following command | ||
|
||
`./roles/magnetocorp.sh` | ||
|
||
This will start a docker container for Fabric CLI commands, and put you in the correct directory for the source code. | ||
|
||
**For a JavaScript Contract:** | ||
|
||
``` | ||
docker exec cliMagnetoCorp peer chaincode install -n papercontract -v 0 -p /opt/gopath/src/github.com/contract -l node | ||
docker exec cliMagnetoCorp peer chaincode instantiate -n papercontract -v 0 -l node -c '{"Args":["org.papernet.commercialpaper:instantiate"]}' -C mychannel -P "AND ('Org1MSP.member')" | ||
``` | ||
|
||
**For a Java Contract:** | ||
|
||
``` | ||
docker exec cliMagnetoCorp peer chaincode install -n papercontract -v 0 -p /opt/gopath/src/github.com/contract-java -l java | ||
docker exec cliMagnetoCorp peer chaincode instantiate -n papercontract -v 0 -l java -c '{"Args":["org.papernet.commercialpaper:instantiate"]}' -C mychannel -P "AND ('Org1MSP.member')" | ||
``` | ||
|
||
> If you want to try both a Java and JavaScript Contract, then you will need to restart the infrastructure and deploy the other contract. | ||
## Client Applications | ||
|
||
Note for Java applications you will need to compile the Java Code using maven. Use this command in each application-java directory | ||
|
||
``` | ||
mvn clean package | ||
``` | ||
|
||
Note for JavaScript applications you will need to install the dependencies first. Use this command in each application directory | ||
|
||
``` | ||
npm install | ||
``` | ||
|
||
|
||
> Note that there is NO dependency between the langauge of any one client application and any contract. Mix and match as you wish! | ||
### Issue the paper | ||
|
||
This is running as *MagnetoCorp* so you can stay in the same window. These commands are to be run in the | ||
`commercial-paper/organization/magnetocorp/application` directory or the `commercial-paper/organization/magnetocorp/application-java` | ||
|
||
*Add the Identity to be used* | ||
|
||
``` | ||
node addToWallet.js | ||
# or | ||
java -cp target/commercial-paper-0.0.1-SNAPSHOT.jar org.magnetocorp.AddToWallet | ||
``` | ||
|
||
*Issue the Commercial Paper* | ||
|
||
``` | ||
node issue.js | ||
# or | ||
java -cp target/commercial-paper-0.0.1-SNAPSHOT.jar org.magnetocorp.Issue | ||
``` | ||
|
||
### Buy and Redeem the paper | ||
|
||
This is running as *Digibank*; you've not acted as this organization before so in your 'Digibank' window run the following command in the | ||
`fabric-samples/commercial-paper/` directory | ||
|
||
`./roles/digibank.sh` | ||
|
||
You can now run the applications to buy and redeem the paper. Change to either the | ||
`commercial-paper/organization/digibank/application` directory or `commercial-paper/organization/digibank/application-java` | ||
|
||
*Add the Identity to be used* | ||
|
||
``` | ||
node addToWallet.js | ||
# or | ||
java -cp target/commercial-paper-0.0.1-SNAPSHOT.jar org.digibank.AddToWallet | ||
``` | ||
|
||
*Buy the paper* | ||
|
||
``` | ||
node buy.js | ||
# or | ||
java -cp target/commercial-paper-0.0.1-SNAPSHOT.jar org.digibank.Buy | ||
``` | ||
|
||
*Redeem* | ||
|
||
``` | ||
node redeem.js | ||
# or | ||
java -cp target/commercial-paper-0.0.1-SNAPSHOT.jar org.digibank.Redeem | ||
``` |
5 changes: 0 additions & 5 deletions
5
commercial-paper/ledger-java-api/org/example/ledger/api/Field.java
This file was deleted.
Oops, something went wrong.
10 changes: 0 additions & 10 deletions
10
commercial-paper/ledger-java-api/org/example/ledger/api/Property.java
This file was deleted.
Oops, something went wrong.
125 changes: 0 additions & 125 deletions
125
commercial-paper/ledger-java-api/org/example/ledger/api/State.java
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
identity |
5 changes: 1 addition & 4 deletions
5
commercial-paper/.classpath → ...tion/digibank/application-java/.classpath
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
1 change: 1 addition & 0 deletions
1
commercial-paper/organization/digibank/application-java/.gitignore
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
target/ |
6 changes: 6 additions & 0 deletions
6
commercial-paper/organization/digibank/application-java/.settings/org.eclipse.jdt.core.prefs
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,6 @@ | ||
eclipse.preferences.version=1 | ||
org.eclipse.jdt.core.compiler.codegen.targetPlatform=1.8 | ||
org.eclipse.jdt.core.compiler.compliance=1.8 | ||
org.eclipse.jdt.core.compiler.problem.forbiddenReference=warning | ||
org.eclipse.jdt.core.compiler.release=disabled | ||
org.eclipse.jdt.core.compiler.source=1.8 |
4 changes: 4 additions & 0 deletions
4
commercial-paper/organization/digibank/application-java/.settings/org.eclipse.m2e.core.prefs
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,4 @@ | ||
activeProfiles= | ||
eclipse.preferences.version=1 | ||
resolveWorkspaceProjects=true | ||
version=1 |
Oops, something went wrong.