From d2e2a8b683ef8fac256e1ca0bf0a322938afd591 Mon Sep 17 00:00:00 2001 From: Paul O'M Date: Mon, 23 Nov 2020 08:56:36 +0000 Subject: [PATCH] Commercial Paper 2.x sample - enhancements and documentation (#335) * commercial paper enhancements Signed-off-by: Paul O'M * commercial paper enhancements Signed-off-by: Paul O'M * commercial paper enhancements Signed-off-by: Paul O'M * Add further README changes from #335 Signed-off-by: Paul O'M * Add further README changes from #335 Signed-off-by: Paul O'M * Add further README changes from #335 Signed-off-by: Paul O'M --- commercial-paper/README.md | 451 ++++++++++++++++-- commercial-paper/img/overview.png | Bin 0 -> 122143 bytes commercial-paper/img/transaction-flow.png | Bin 0 -> 21986 bytes .../digibank/application/buy_request.js | 105 ++++ .../digibank/application/queryapp.js | 155 ++++++ .../digibank/application/redeem.js | 3 +- .../digibank/contract/ledger-api/state.js | 11 +- .../digibank/contract/lib/paper.js | 21 +- .../digibank/contract/lib/papercontract.js | 217 ++++++++- .../digibank/contract/lib/paperlist.js | 2 +- .../digibank/contract/lib/queries.js | 215 +++++++++ .../magnetocorp/application/cpListener.js | 97 ++++ .../magnetocorp/application/transfer.js | 103 ++++ .../magnetocorp/contract/ledger-api/state.js | 11 +- .../magnetocorp/contract/lib/paper.js | 21 +- .../magnetocorp/contract/lib/papercontract.js | 217 ++++++++- .../magnetocorp/contract/lib/paperlist.js | 2 +- .../magnetocorp/contract/lib/queries.js | 215 +++++++++ 18 files changed, 1754 insertions(+), 92 deletions(-) create mode 100644 commercial-paper/img/overview.png create mode 100644 commercial-paper/img/transaction-flow.png create mode 100644 commercial-paper/organization/digibank/application/buy_request.js create mode 100644 commercial-paper/organization/digibank/application/queryapp.js create mode 100644 commercial-paper/organization/digibank/contract/lib/queries.js create mode 100644 commercial-paper/organization/magnetocorp/application/cpListener.js create mode 100644 commercial-paper/organization/magnetocorp/application/transfer.js create mode 100644 commercial-paper/organization/magnetocorp/contract/lib/queries.js diff --git a/commercial-paper/README.md b/commercial-paper/README.md index 4aa6056c..77bcc09f 100644 --- a/commercial-paper/README.md +++ b/commercial-paper/README.md @@ -1,27 +1,110 @@ -# 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 walk-through is in the [Hyperledger Fabric Commercial Paper Tutorial](https://hyperledger-fabric.readthedocs.io/en/latest/tutorial/commercial_paper.html). +# Commercial Paper Tutorial & Samples -## Scenario +## Introduction -In this tutorial two organizations, MagnetoCorp and DigiBank, trade commercial paper with each other using 'PaperNet', a Hyperledger Fabric blockchain network. +This folder contains a structured set of smart contracts and application clients (ie. in a choice of languages, eg Node.js, Java, Go etc) relating to *Commercial Paper*, a finance 'instrument' (in Global Finance). At present, the Node.js sample contract in particular has further added functionality: an optional two-step authority check (see diagram below), when redeeming a commercial paper instance - and a range of sample ledger queries, to help consolidate your learning; both can be explored using the Node.js application client. -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. +While a more detailed 'explainer' of the Commercial Paper scenario (including use case analysis, code walkthrough & practices, logical/physical representation of ledger data etc) can be found in the [Hyperledger Fabric Commercial Paper Tutorial](https://hyperledger-fabric.readthedocs.io/en/latest/tutorial/commercial_paper.html), you don't have to read through this, just to try out this sample. There's also a [Wikipedia page](https://en.wikipedia.org/wiki/Commercial_paper) + +
Key Objectives + + * see a Commercial Paper use case in action + + * explore the key 'takeaways': understand differences between asset _state_ changes ('e.g. 'lifecycle') and transaction _inputs_* (e.g. 'inputs' during lifecycle) + + * try out a number of different query types: asset history, asset state, ownership, partial key, named query (criteria-based), ad-hoc queries (you supply a query string) - presently available in the Node.js sample only. + + \* the smart contract uses these (along with business logic) to decide outcomes; some inputs change the asset _state_ (like 'ownership') ; some don't. + +

+
+ +
Blockchain: benefits to Commercial Paper marketplaces? + + * replace long-winded, time consuming processing between multiple organisations - the network makes it one centralized hub and helps simplify workflow. + + * full transparency, traceability and ownership of issued papers + + * speed up a process that can take days - e. make same-day issuance a reality, or even a market paradigm. + + * in asset-backed commercial paper markets, blockchain can help increase accessibility (to a marketplace) to SMEs to partake in issuance, where otherwise it was inaccessible. + + * integration to other areas, like supply chain finance + +

+
+ + + Expand the twisty below to see an overview diagram of a 'sample' Commercial paper marketplace - transactions, queries being executed by different organisations (we'll focus on two of these organisations) + +
PaperNet Overview diagram - The sample commercial paper marketplace + +![PaperNet Overview](img/overview.png) + +

+
+ +But first, it might useful to explain Commercial Paper, an unsecured promissory note issued to obtain capital, and operates in global financial markets. A Commercial Paper instance is represented as an asset with a lifecycle, recorded on the blockchain - transactions change its _state_ (over time) and those transactions, naturally - have _inputs_. + + +#### Explainers + +
Commercial Paper - what is it briefly? + +
+It is a type of unsecured promissory note, issued by established companies (eg big manufacturers, blue chip corporations) to gain short-term capital - usually no more than 6-9 months. Why? To meet short-term financial obligations. Commercial paper is generally purchased by money market funds and banks - in fact, it becomes a more important investment strategy during financial recessions :-) . A corporation issues a paper (in the form of a promissory note) for specific projects, such as big capital investments, to pay contractors or even to exercise debt restructuring. The tutorial describes MagnetoCorp (car manufacturer) who have landed a huge contract, and will need approx. $5m in capital (payroll obligations), to hire 1000 car workers for at least 6 months (with no car revenues yet - its a financial strain). Underpinning this, of course, is that MagnetoCorp, has every confidence that (say, in 6 months time) it will be in a position to pay out the face value ($5m in this case) when the commercial paper is redeemd by an owner of the paper, upon maturity :-). +

+
+ +
Ins and Outs, Attractions of Commercial Paper Investment? + +
+Investors (who buy Commercial Paper) are attracted as they agree to buy them at a discount (say $4.94m) on the face value (eg $5m) and moreso, they obtain a higher yield than if they were simply gaining interest in a bank (eg. 2% interest on $4.95m today = $5m in 6 months time). But there is a 'premium' attached, with carrying the risk of a debt/loan that is essentially unsecured (unlike a bank) - which is where credit risk and ratings comes in. As a result, the actual yield from the investment chosen is in effect $10k greater (than pure interest, in the example given). +

+Once an issuing corporation becomes established in the commercial paper marketplace, it builds a high credit rating (risk affects how much of a premium investors seek and therefore discount accordingly) - in fact, it is often cheaper (for a blue chip company) to draw on a commercial paper than on a bank line of credit. But that rating reflects the issuer's ability to pay back on maturity. +

+I mentioned marketplace: even during the typical 6-9 month period, a commercial paper can be bought and sold multiple times (its quoted, at the discounted price on money markets), before the Commercial Paper reaches its maturity date. On that date, the current investor (or owner) 'redeems' the paper bond with MagnetoCorp, the issuer and gets the face value of $5m. + +
+ +[_back to top_](#top) + +## Scenario Overview ![](https://hyperledger-fabric.readthedocs.io/en/latest/_images/commercial_paper.diagram.1.png) +In this tutorial two organizations, MagnetoCorp and DigiBank, trade commercial paper with each other on 'PaperNet', the marketplace represented by a Hyperledger Fabric blockchain network. Note that there are two alternative transaction flows - one which mirrors the [Commercial Paper Tutorial](https://hyperledger-fabric.readthedocs.io/en/latest/tutorial/commercial_paper.html) as described in Fabric documentation, and one which requires the authorised owner of the paper to complete a transfer following a request to buy the commercial paper - the latter example features an authorization check in the smart contract that ensures the transactor is from the organization that currently owns the commercial paper - they approve and complete the buy request. These are the commercial paper transaction lifecycles you can try out: + +![Transaction Flow alternatives](img/transaction-flow.png) + +The tutorial exercises the commercial paper asset lifecycle: _issue_, _buy_ ( 1 to _n_ ) (or _buy_request_ / _transfer_ alternative), and _redeem_ transactions: the key 'takeaways' from the scenario are: + +- understanding the _changes in state_ in the commercial paper asset (reflected in the ledger world state) which reaches maturity after 6 months. +- understanding the _transaction inputs_ for each transaction (some inputs change the asset _state_ - eg. ownership) and some _don't_ (e.g. purchase price) and not part of the asset - but importantly, the _inputs_ for a given transaction are recorded on the blockchain). +- understanding the importance of _queries_ such as: asset history, rich queries (criteria matching etc), transaction history (where the inputs are recorded) + +Client applications (CLI based) are used: + +- to perform the transactions +- run queries (Node.js sample only) +- examine the transaction inputs (as opposed to _states_) that are written to the ledger after you perform a transaction (using the Node.js listener). + +This sample uses the `test-network` . You’ll act as Isabella, an employee of MagnetoCorp (Org2), who will issue a commercial paper on its behalf. You’ll then 'switch hats' to take the role of Balaji, an employee of DigiBank (Org1), who will buy this commercial paper, hold it for a period of time, and then redeem it with MagnetoCorp for a small profit or yield. Note that the smart contract sample doesn't enforce the actual hold period ; the user can, in fact, redeem the paper immediately. + + ## 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 without extensive details of what is happening. +Below are the quick start instructions for running the tutorial. As mentioned, if you're interested in a 'deeper dive' analysis and importance of the concepts, design, structure and implementation of the smart contract, they can be found in the [Hyperledger Fabric Commercial Paper Tutorial](https://hyperledger-fabric.readthedocs.io/en/latest/tutorial/commercial_paper.html). Suffice to say, you DON'T have to have read this, to do this tutorial. This `README.md` file is in the `commercial-paper` directory, the source code for client applications and the contracts is in the `organization` directory. -### Steps +### High-Level Overview of Steps -1) Start the Hyperledger Fabric infrastructure +1) Install Binaries, Start the Hyperledger Fabric infrastructure - The 'test-network' will be used - this has two organizations 'org1' and 'org2' DigiBank will be org1, and MagnetoCorp will be org2. + The Fabric 'test-network' will be used - this has two organizations 'Org1' and 'Org2' DigiBank will be Org1, and MagnetoCorp will be Org2. 2) Install and Instantiate the Contracts @@ -31,6 +114,10 @@ This `README.md` file is in the `commercial-paper` directory, the source code fo - Buy the paper as DigiBank (org1) - Redeem the paper as DigiBank (org1) + See also the transaction flow and alternatives in the Scenario Overview below. + +[_back to top_](#top) + ## Setup You will need a machine with the following @@ -40,10 +127,26 @@ You will need a machine with the following - Java v8 if you want to run Java client applications - Maven to build the Java applications -You will need to install the peer cli binaries and this fabric-samples repository available. For more information -[Install the Samples, Binaries and Docker Images](https://hyperledger-fabric.readthedocs.io/en/latest/install.html) in the Hyperledger Fabric documentation. +You will need to install the `peer` cli binaries and cloned the `fabric-samples` repository. For more information see +[Install the Samples, Binaries and Docker Images](https://hyperledger-fabric.readthedocs.io/en/latest/install.html) in the Hyperledger Fabric documentation. Once you have installed the cli binaries, ensure you have added the `bin` directory (for your `peer` commands used by scripts below) to your exported `PATH` variable in your `.bashrc` or `.profile` directory (per below). This is important as you will be opening a number of windows which will need PATH set. Finally, check that it finds the `peer` command in your PATH using the `which` command eg. -It is advised to have 3 console windows open; one to monitor the infrastructure and one each for MagnetoCorp and DigiBank. Once you've cloned the fabric-samples - change to the commercial-paper directory in each window. +``` +export PATH=:$PATH +which peer +``` + + +It is advised to have 3 terminal windows (consoles) open; + +* one to monitor the infrastructure +* one for MagnetoCorp +* one for DigiBank. + +Once you've cloned the `fabric-samples` - change to the `commercial-paper` directory in each window. + +``` +git clone https://github.com/hyperledger/fabric-samples.git +``` ``` cd fabric-samples/commercial-paper @@ -51,9 +154,13 @@ cd fabric-samples/commercial-paper ## Running the Infrastructure -In one console window, run the `./network-starter.sh` script; this will start the basic infrastructure. +In one console window, run the network starter script - this will start the two organization `test-network` blockchain network. -You can re-use this console window if you wish, but it is recommended to run a docker container monitoring script. This will let you view what Fabric is doing and help diagnose any failures. +``` +./network-starter.sh +``` + +You can re-use this console window if you wish, but it is recommended to run a docker container monitoring script in its own window. This will let you view what Fabric is doing and help diagnose any failures. ```bash ./organization/magnetocorp/configuration/cli/monitordocker.sh net_test @@ -63,11 +170,11 @@ You can re-use this console window if you wish, but it is recommended to run a d The contract code is available as either JavaScript, Java or Go. You can use either one, and the choice of contract language does not affect the choice of client language. With the v2.0 Fabric chaincode lifecycle, this requires operations for both MagnetoCorp and Digibank admin. Open two windows in the fabric-samples/commercial paper directory, one for each organization. -In your 'MagnetoCorp' window run the following commands, to show the shell environment variables needed to act as that organization. +In your 'MagnetoCorp' window run the following commands, to set the shell environment variables needed to act as that organization. The leading '.' in the command sequence sets in your current environment - if you do not run this, you will not be able to package the chaincode. ``` cd fabric-samples/commercial-paper/organization/magnetocorp -./magnetocorp.sh +. ./magnetocorp.sh ``` You can either copy and paste them directly into the terminal, or invoke directly in your own command shell. For example if you are using bash or zsh on Linux you can use this command. @@ -76,21 +183,27 @@ You can either copy and paste them directly into the terminal, or invoke directl source <(./magnetocorp.sh) ``` -Similarly in your 'DigiBank' window run the following command +Similarly in your 'DigiBank' window run the following commands as shown: ``` cd fabric-samples/commercial-paper/organization/digibank -./digibank.sh +. ./digibank.sh ``` +[_back to top_](#top) + + ### Deploy the smart contract to the channel -You need to perform similar operations for both organizations. For different contract languages the steps are very similar. The steps for JavaScript are shown first, with the details of different languages afterwards. +You need to perform similar operations for _both_ organizations and for your language choice from the instructions below. For the different contract languages, the steps are very similar - the full set of steps are actually shown in the JavaScript section (see twisty). However, you will perform one or two different initial steps for Java or Go before completing the remaining common steps as instructed in those language sections. + +Note that the commands below make use of the `jq` utility for parsing output - download and install it from [here](https://stedolan.github.io/jq/download/) -**For a JavaScript Contract** +**
For a JavaScript Contract** -Running in MagnetoCorp: + +Running in MagnetoCorp directory: ``` # MAGNETOCORP @@ -99,7 +212,10 @@ peer lifecycle chaincode package cp.tar.gz --lang node --path ./contract --label peer lifecycle chaincode install cp.tar.gz export PACKAGE_ID=$(peer lifecycle chaincode queryinstalled --output json | jq -r '.installed_chaincodes[0].package_id') -echo $PACKAGE_ID +echo $PACKAGE_ID # FYI may look like this: 'cp_0:nnnxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' +``` + +``` peer lifecycle chaincode approveformyorg --orderer localhost:7050 --ordererTLSHostnameOverride orderer.example.com \ --channelID mychannel \ @@ -113,7 +229,7 @@ peer lifecycle chaincode approveformyorg --orderer localhost:7050 --ordererTLSH peer lifecycle chaincode checkcommitreadiness --channelID mychannel --name papercontract -v 0 --sequence 1 ``` -Running in Digibank +Running in Digibank directory: ``` @@ -153,7 +269,7 @@ peer lifecycle chaincode commit -o localhost:7050 \ ``` -To test try sending some simple transactions. +To test, try sending some simple transactions. ``` @@ -169,50 +285,227 @@ peer chaincode query -o localhost:7050 --ordererTLSHostnameOverride orderer.exa --name papercontract \ -c '{"Args":["org.hyperledger.fabric:GetMetadata"]}' \ --peerAddresses localhost:9051 --tlsRootCertFiles ${PEER0_ORG2_CA} \ - --tls --cafile $ORDERER_CA | jq -C | more + --tls --cafile $ORDERER_CA | jq '.' -C | more ``` +

+
-**For a Java Contract:** -Before the `peer lifecycle chaincode package` command, you will need to change into each organization's `contract-java` directory and issue +**
For a Java Contract:** + + +Before the `peer lifecycle chaincode package` command below, you will first need to change into each organization's `contract-java` directory and issue ``` ./gradlew build ``` -Then from the parent directory when you package the contract, use this variation of the command to specify the java specific contract +Then complete the steps below. + + +Running in MagnetoCorp contract directory: + ``` +# MAGNETOCORP + peer lifecycle chaincode package cp.tar.gz --lang java --path ./contract-java --label cp_0 +peer lifecycle chaincode install cp.tar.gz + +export PACKAGE_ID=$(peer lifecycle chaincode queryinstalled --output json | jq -r '.installed_chaincodes[0].package_id') +echo $PACKAGE_ID # FYI may look like this: 'cp_0:nnnxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' ``` -After this point the steps are exactly the same as for JavaScript +``` -**For a Go Contract:** +peer lifecycle chaincode approveformyorg --orderer localhost:7050 --ordererTLSHostnameOverride orderer.example.com \ + --channelID mychannel \ + --name papercontract \ + -v 0 \ + --package-id $PACKAGE_ID \ + --sequence 1 \ + --tls \ + --cafile $ORDERER_CA + +peer lifecycle chaincode checkcommitreadiness --channelID mychannel --name papercontract -v 0 --sequence 1 +``` + +Running in Digibank + +``` + +# DIGIBANK + +peer lifecycle chaincode package cp.tar.gz --lang java --path ./contract-java --label cp_0 +peer lifecycle chaincode install cp.tar.gz + +export PACKAGE_ID=$(peer lifecycle chaincode queryinstalled --output json | jq -r '.installed_chaincodes[0].package_id') +echo $PACKAGE_ID + +peer lifecycle chaincode approveformyorg --orderer localhost:7050 --ordererTLSHostnameOverride orderer.example.com \ + --channelID mychannel \ + --name papercontract \ + -v 0 \ + --package-id $PACKAGE_ID \ + --sequence 1 \ + --tls \ + --cafile $ORDERER_CA + +peer lifecycle chaincode checkcommitreadiness --channelID mychannel --name papercontract -v 0 --sequence 1 + +``` + +Once both organizations have installed, and approved the chaincode, it can be committed. + +``` +# MAGNETOCORP + +peer lifecycle chaincode commit -o localhost:7050 \ + --peerAddresses localhost:7051 --tlsRootCertFiles ${PEER0_ORG1_CA} \ + --peerAddresses localhost:9051 --tlsRootCertFiles ${PEER0_ORG2_CA} \ + --ordererTLSHostnameOverride orderer.example.com \ + --channelID mychannel --name papercontract -v 0 \ + --sequence 1 \ + --tls --cafile $ORDERER_CA --waitForEvent + +``` + +To test, try sending some simple transactions. + +``` + +peer chaincode invoke -o localhost:7050 --ordererTLSHostnameOverride orderer.example.com \ + --peerAddresses localhost:7051 --tlsRootCertFiles ${PEER0_ORG1_CA} \ + --peerAddresses localhost:9051 --tlsRootCertFiles ${PEER0_ORG2_CA} \ + --channelID mychannel --name papercontract \ + -c '{"Args":["org.papernet.commercialpaper:instantiate"]}' ${PEER_ADDRESS_ORG1} ${PEER_ADDRESS_ORG2} \ + --tls --cafile $ORDERER_CA --waitForEvent + +peer chaincode query -o localhost:7050 --ordererTLSHostnameOverride orderer.example.com \ + --channelID mychannel \ + --name papercontract \ + -c '{"Args":["org.hyperledger.fabric:GetMetadata"]}' \ + --peerAddresses localhost:9051 --tlsRootCertFiles ${PEER0_ORG2_CA} \ + --tls --cafile $ORDERER_CA | jq '.' -C | more +``` + +

+
+ +**
For a Go Contract** -Before the `peer lifecycle chaincode package` command, you will need to change into each organization's `contract-go` directory and issue +Before the `peer lifecycle chaincode package` command step, you will need to change into each organization's `contract-go` directory and issue ``` go mod vendor ``` -Then from the parent directory when you package the contract, use this variation of the command to specify the go specific contract +Then complete the steps below. + + +Running in MagnetoCorp contract directory: + ``` +# MAGNETOCORP + peer lifecycle chaincode package cp.tar.gz --lang golang --path ./contract-go --label cp_0 +peer lifecycle chaincode install cp.tar.gz + +export PACKAGE_ID=$(peer lifecycle chaincode queryinstalled --output json | jq -r '.installed_chaincodes[0].package_id') +echo $PACKAGE_ID # FYI may look like this: 'cp_0:nnnxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' ``` -After this point the steps are exactly the same as for JavaScript +``` + +peer lifecycle chaincode approveformyorg --orderer localhost:7050 --ordererTLSHostnameOverride orderer.example.com \ + --channelID mychannel \ + --name papercontract \ + -v 0 \ + --package-id $PACKAGE_ID \ + --sequence 1 \ + --tls \ + --cafile $ORDERER_CA + +peer lifecycle chaincode checkcommitreadiness --channelID mychannel --name papercontract -v 0 --sequence 1 +``` + +Running in Digibank + +``` + +# DIGIBANK + +peer lifecycle chaincode package cp.tar.gz --lang golang --path ./contract-go --label cp_0 +peer lifecycle chaincode install cp.tar.gz + +export PACKAGE_ID=$(peer lifecycle chaincode queryinstalled --output json | jq -r '.installed_chaincodes[0].package_id') +echo $PACKAGE_ID + +peer lifecycle chaincode approveformyorg --orderer localhost:7050 --ordererTLSHostnameOverride orderer.example.com \ + --channelID mychannel \ + --name papercontract \ + -v 0 \ + --package-id $PACKAGE_ID \ + --sequence 1 \ + --tls \ + --cafile $ORDERER_CA + +peer lifecycle chaincode checkcommitreadiness --channelID mychannel --name papercontract -v 0 --sequence 1 + +``` + +Once both organizations have installed, and approved the chaincode, it can be committed. + +``` +# MAGNETOCORP + +peer lifecycle chaincode commit -o localhost:7050 \ + --peerAddresses localhost:7051 --tlsRootCertFiles ${PEER0_ORG1_CA} \ + --peerAddresses localhost:9051 --tlsRootCertFiles ${PEER0_ORG2_CA} \ + --ordererTLSHostnameOverride orderer.example.com \ + --channelID mychannel --name papercontract -v 0 \ + --sequence 1 \ + --tls --cafile $ORDERER_CA --waitForEvent + +``` + +To test, try sending some simple transactions. + +``` + +peer chaincode invoke -o localhost:7050 --ordererTLSHostnameOverride orderer.example.com \ + --peerAddresses localhost:7051 --tlsRootCertFiles ${PEER0_ORG1_CA} \ + --peerAddresses localhost:9051 --tlsRootCertFiles ${PEER0_ORG2_CA} \ + --channelID mychannel --name papercontract \ + -c '{"Args":["org.papernet.commercialpaper:instantiate"]}' ${PEER_ADDRESS_ORG1} ${PEER_ADDRESS_ORG2} \ + --tls --cafile $ORDERER_CA --waitForEvent + +peer chaincode query -o localhost:7050 --ordererTLSHostnameOverride orderer.example.com \ + --channelID mychannel \ + --name papercontract \ + -c '{"Args":["org.hyperledger.fabric:GetMetadata"]}' \ + --peerAddresses localhost:9051 --tlsRootCertFiles ${PEER0_ORG2_CA} \ + --tls --cafile $ORDERER_CA | jq '.' -C | more +``` + + + +

+
+ + +[_back to top_](#top) ## Client Applications -Note for Java applications you will need to compile the Java Code using maven. Use this command in each application-java directory +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 +Note for JavaScript applications, you will need to install the dependencies first. Use this command in each application directory ``` npm install @@ -221,12 +514,22 @@ npm install The docker containers don't contain the node or Java runtimes; so it is best to exit the docker containers - but keep the windows open and run the applications locally. -### Issue the paper +As mentioned earlier in the Sample introduction section, transaction _inputs_ are recorded on the ledger, as well as any asset _state_ changes. Just *before* you run the _issue_ application script below - you need to launch a block 'listener' application that will show you these _inputs_, as you complete each transaction in the commercial paper lifecycle (eg. Paper Number: 00001, 00002 etc) . -This is running as *MagnetoCorp* These commands are to be run in the -`commercial-paper/organization/magnetocorp/application` directory or the `commercial-paper/organization/magnetocorp/application-java` +For the listener, its best to open a *new* terminal for this in the `commercial-paper/organization/magnetocorp/application` directory (javascript). Next, run the `addToWallet` step in the `issue` transaction below, to add Isabella's identity to the wallet - the listener will use this wallet. Once the listener is launched, it will show the inputs for transactions you will perform and which are committed to blocks (ie part of the ledger). Note: initially, the listener may show a spurious message, and then go into a _listening_ or 'wait' state. As transactions complete below, messages will be displayed by the listener - so keep an eye out. *After* adding Isabella's wallet, you can then launch the listener as follows: -*Add the Identity to be used* +``` +node cpListener.js +``` + +**
Issue the commercial paper** + +The paper is issued by *MagnetoCorp* + +You can now run the applications to issue the commercial paper. Change to either the +`commercial-paper/organization/magnetocorp/application` directory (javascript) or `commercial-paper/organization/magnetocorp/application-java` directory (java) + +*Add the Identity to be used to the wallet* ``` node addToWallet.js @@ -242,11 +545,17 @@ node issue.js java -cp target/commercial-paper-0.0.1-SNAPSHOT.jar org.magnetocorp.Issue ``` -### Buy and Redeem the paper +Don't forget to check the application listener for messages above! -This is running as *Digibank*; +

+
-You can now run the applications to buy and redeem the paper. Change to either the + +**
Buy the commercial paper** + +_Buy_ is performed as *Digibank*; + +You can now run the applications to buy 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* @@ -265,6 +574,33 @@ node buy.js java -cp target/commercial-paper-0.0.1-SNAPSHOT.jar org.digibank.Buy ``` +If you have just executed a `buy` transaction above - jump to the `redeem` transaction below - otherwise execute the _buy_/_transfer_ sequence as described earlier. + +*Alternative: Request to Buy the paper (buy/transfer)* + +``` +node buy_request.js +``` + +Now complete the _request_ by switching to the `MagnetoCorp` application directory (javascript) and execute a `transfer` transaction as MagnetoCorp: + +``` +cd ../../magnetocorp/application + +node transfer.js +``` + +

+
+ +**
Redeem the commercial paper** + +_Redeem_ is performed as *Digibank* - the current owner (buyer) in the lifecycle. + +You can now run the applications to redeem the paper. Change to either the +`commercial-paper/organization/digibank/application` directory or `commercial-paper/organization/digibank/application-java` + + *Redeem* ``` @@ -273,9 +609,38 @@ node redeem.js java -cp target/commercial-paper-0.0.1-SNAPSHOT.jar org.digibank.Redeem ``` +

+
+ + +**
Perform Queries: Ownership, Asset History etc (Node.js sample only) ** + + Having completed the full commercial paper lifecycle for one paper (paper number: 00001) some queries below won't show a lot of data - as an optional exercise, you can change the scripts above (paper number: 00002) to create another paper lifecycle and run the `queryapp` application below (change query 1 to the new CP number FYI), with more data available. As indicated, the query transactions mentioned are presently only available in the Node.js sample. + + Execute the Node.js application client script, which will run the following 5 queries, in order: + + - History of Commercial Paper (Note: the paper state is shown more descriptively eg. 'ISSUED', 'TRADING' and based on currentState values on ledger) + - Ownership of Commercial Papers + - Partial Key query, for Commercial papers in org.papernet.papers namespace belonging to MagnetoCorp + - Named Query: all redeemed papers in a state of 'redeemed' (currentState = 4) + - Named Query: all commercial papers with a face value > $4m + + From the `digibank/application` subdirectory run: + + ``` + node queryapp.js + ``` + +

+
+ +When you're done with this section, return to the terminal where your Node.js _listener_ application is running, and terminate the process. + ## Clean up When you are finished using the Fabric test network and the commercial paper smart contract and applications, you can use the following command to clean up the network: ``` ./network-clean.sh ``` + +[_back to top_](#top) diff --git a/commercial-paper/img/overview.png b/commercial-paper/img/overview.png new file mode 100644 index 0000000000000000000000000000000000000000..9da7aced3a6f91968535c95aa52433bff87881cd GIT binary patch literal 122143 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%0AM-pdkFTW=ixLJa?v{5dpI0M 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≪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 literal 0 HcmV?d00001 diff --git a/commercial-paper/organization/digibank/application/buy_request.js b/commercial-paper/organization/digibank/application/buy_request.js new file mode 100644 index 00000000..1493b806 --- /dev/null +++ b/commercial-paper/organization/digibank/application/buy_request.js @@ -0,0 +1,105 @@ +/* + * Copyright IBM Corp. All Rights Reserved. + * + * SPDX-License-Identifier: Apache-2.0 +*/ + +/* + * This application has 6 basic steps: + * 1. Select an identity from a wallet + * 2. Connect to network gateway + * 3. Access PaperNet network + * 4. Construct request to buy (buy_request) commercial paper + * 5. Submit transaction + * 6. Process response + */ + +'use strict'; + +// Bring key classes into scope, most importantly Fabric SDK network class +const fs = require('fs'); +const yaml = require('js-yaml'); +const { Wallets, Gateway } = require('fabric-network'); +const CommercialPaper = require('../../magnetocorp/contract/lib/paper.js'); + + +// Main program function +async function main () { + + // A wallet stores a collection of identities for use + const wallet = await Wallets.newFileSystemWallet('../identity/user/balaji/wallet'); + + + // A gateway defines the peers used to access Fabric networks + const gateway = new Gateway(); + + // Main try/catch block + try { + + // Specify userName for network access + const userName = 'balaji'; + + // Load connection profile; will be used to locate a gateway + let connectionProfile = yaml.safeLoad(fs.readFileSync('../gateway/connection-org1.yaml', 'utf8')); + + // Set connection options; identity and wallet + let connectionOptions = { + identity: userName, + wallet: wallet, + discovery: { enabled: true, asLocalhost: true } + + }; + + // Connect to gateway using application specified parameters + console.log('Connect to Fabric gateway.'); + + await gateway.connect(connectionProfile, connectionOptions); + + // Access PaperNet network + console.log('Use network channel: mychannel.'); + + const network = await gateway.getNetwork('mychannel'); + + // Get addressability to commercial paper contract + console.log('Use org.papernet.commercialpaper smart contract.'); + + const contract = await network.getContract('papercontract', 'org.papernet.commercialpaper'); + + // request to buy commercial paper using buy_request / transfer two-part transaction + console.log('Submit commercial paper buy_request transaction.'); + + const buyResponse = await contract.submitTransaction('buy_request', 'MagnetoCorp', '00001', 'MagnetoCorp', 'DigiBank', '4900000', '2020-05-31'); + + // process response + console.log('Process buy_request transaction response.'); + + let paper = CommercialPaper.fromBuffer(buyResponse); + + console.log(`${paper.issuer} commercial paper : ${paper.paperNumber} has been provisionally purchased : the transfer must now be completed by paper owner`); + console.log('Transaction complete.'); + + } catch (error) { + + console.log(`Error processing transaction. ${error}`); + console.log(error.stack); + + } finally { + + // Disconnect from the gateway + console.log('Disconnect from Fabric gateway.'); + gateway.disconnect(); + + } +} +main().then(() => { + + console.log('Buy_request program complete.'); + +}).catch((e) => { + + console.log('Buy_request program exception.'); + console.log(e); + console.log(e.stack); + process.exit(-1); + +}); diff --git a/commercial-paper/organization/digibank/application/queryapp.js b/commercial-paper/organization/digibank/application/queryapp.js new file mode 100644 index 00000000..fcba8fad --- /dev/null +++ b/commercial-paper/organization/digibank/application/queryapp.js @@ -0,0 +1,155 @@ +/* + * Copyright IBM Corp. All Rights Reserved. + * + * SPDX-License-Identifier: Apache-2.0 +*/ + +/* + * This application has 6 basic steps: + * 1. Select an identity from a wallet + * 2. Connect to network gateway + * 3. Access PaperNet network + * 4. Construct request to query the ledger + * 5. Evaluate transactions (queries) + * 6. Process responses + */ + +'use strict'; + +// Bring key classes into scope, most importantly Fabric SDK network class +const fs = require('fs'); +const yaml = require('js-yaml'); +const { Wallets, Gateway } = require('fabric-network'); + + +// Main program function +async function main() { + + // A wallet stores a collection of identities for use + const wallet = await Wallets.newFileSystemWallet('../identity/user/balaji/wallet'); + + + // A gateway defines the peers used to access Fabric networks + const gateway = new Gateway(); + + // Main try/catch block + try { + + // Specify userName for network access + const userName = 'balaji'; + + // Load connection profile; will be used to locate a gateway + let connectionProfile = yaml.safeLoad(fs.readFileSync('../gateway/connection-org1.yaml', 'utf8')); + + // Set connection options; identity and wallet + let connectionOptions = { + identity: userName, + wallet: wallet, + discovery: { enabled: true, asLocalhost: true } + + }; + + // Connect to gateway using application specified parameters + console.log('Connect to Fabric gateway.'); + + await gateway.connect(connectionProfile, connectionOptions); + + // Access PaperNet network + console.log('Use network channel: mychannel.'); + + const network = await gateway.getNetwork('mychannel'); + + // Get addressability to commercial paper contract + console.log('Use org.papernet.commercialpaper smart contract.'); + + const contract = await network.getContract('papercontract', 'org.papernet.commercialpaper'); + + // queries - commercial paper + console.log('-----------------------------------------------------------------------------------------'); + console.log('****** Submitting commercial paper queries ****** \n\n '); + + + // 1 asset history + console.log('1. Query Commercial Paper History....'); + console.log('-----------------------------------------------------------------------------------------\n'); + let queryResponse = await contract.evaluateTransaction('queryHistory', 'MagnetoCorp', '00001'); + + let json = JSON.parse(queryResponse.toString()); + console.log(json); + console.log('\n\n'); + console.log('\n History query complete.'); + console.log('-----------------------------------------------------------------------------------------\n\n'); + + // 2 ownership query + console.log('2. Query Commercial Paper Ownership.... Papers owned by MagnetoCorp'); + console.log('-----------------------------------------------------------------------------------------\n'); + let queryResponse2 = await contract.evaluateTransaction('queryOwner', 'MagnetoCorp'); + json = JSON.parse(queryResponse2.toString()); + console.log(json); + + console.log('\n\n'); + console.log('\n Paper Ownership query complete.'); + console.log('-----------------------------------------------------------------------------------------\n\n'); + + // 3 partial key query + console.log('3. Query Commercial Paper Partial Key.... Papers in org.papernet.papers namespace and prefixed MagnetoCorp'); + console.log('-----------------------------------------------------------------------------------------\n'); + let queryResponse3 = await contract.evaluateTransaction('queryPartial', 'MagnetoCorp'); + + json = JSON.parse(queryResponse3.toString()); + console.log(json); + console.log('\n\n'); + + console.log('\n Partial Key query complete.'); + console.log('-----------------------------------------------------------------------------------------\n\n'); + + + // 4 Named query - all redeemed papers + console.log('4. Named Query: ... All papers in org.papernet.papers that are in current state of redeemed'); + console.log('-----------------------------------------------------------------------------------------\n'); + let queryResponse4 = await contract.evaluateTransaction('queryNamed', 'redeemed'); + + json = JSON.parse(queryResponse4.toString()); + console.log(json); + console.log('\n\n'); + + console.log('\n Named query "redeemed" complete.'); + console.log('-----------------------------------------------------------------------------------------\n\n'); + + + // 5 named query - by value + console.log('5. Named Query:.... All papers in org.papernet.papers with faceValue > 4000000'); + console.log('-----------------------------------------------------------------------------------------\n'); + let queryResponse5 = await contract.evaluateTransaction('queryNamed', 'value'); + + json = JSON.parse(queryResponse5.toString()); + console.log(json); + console.log('\n\n'); + + console.log('\n Named query by "value" complete.'); + console.log('-----------------------------------------------------------------------------------------\n\n'); + } catch (error) { + + console.log(`Error processing transaction. ${error}`); + console.log(error.stack); + + } finally { + + // Disconnect from the gateway + console.log('Disconnect from Fabric gateway.'); + gateway.disconnect(); + + } +} +main().then(() => { + + console.log('Queryapp program complete.'); + +}).catch((e) => { + + console.log('Queryapp program exception.'); + console.log(e); + console.log(e.stack); + process.exit(-1); + +}); diff --git a/commercial-paper/organization/digibank/application/redeem.js b/commercial-paper/organization/digibank/application/redeem.js index 53ea884c..0f6699e8 100644 --- a/commercial-paper/organization/digibank/application/redeem.js +++ b/commercial-paper/organization/digibank/application/redeem.js @@ -68,7 +68,7 @@ async function main() { // redeem commercial paper console.log('Submit commercial paper redeem transaction.'); - const redeemResponse = await contract.submitTransaction('redeem', 'MagnetoCorp', '00001', 'DigiBank', '2020-11-30'); + const redeemResponse = await contract.submitTransaction('redeem', 'MagnetoCorp', '00001', 'DigiBank', 'Org2MSP', '2020-11-30'); // process response console.log('Process redeem transaction response.'); @@ -76,6 +76,7 @@ async function main() { let paper = CommercialPaper.fromBuffer(redeemResponse); console.log(`${paper.issuer} commercial paper : ${paper.paperNumber} successfully redeemed with ${paper.owner}`); + console.log('Transaction complete.'); } catch (error) { diff --git a/commercial-paper/organization/digibank/contract/ledger-api/state.js b/commercial-paper/organization/digibank/contract/ledger-api/state.js index a2f92273..f63e792e 100644 --- a/commercial-paper/organization/digibank/contract/ledger-api/state.js +++ b/commercial-paper/organization/digibank/contract/ledger-api/state.js @@ -38,9 +38,11 @@ class State { return this.currentState; } - serialize() { + // not used +/* serialize() { + return State.serialize(this); - } + } */ /** * Convert object to buffer containing JSON data serialization @@ -49,6 +51,8 @@ class State { * @return {buffer} buffer with the data to store */ static serialize(object) { + // don't write the key:value passed in - we already have a real composite key, issuer and paper Number. + delete object.key; return Buffer.from(JSON.stringify(object)); } @@ -88,7 +92,8 @@ class State { * @param (String[]) keyParts */ static makeKey(keyParts) { - return keyParts.map(part => JSON.stringify(part)).join(':'); + // return keyParts.map(part => JSON.stringify(part)).join(':'); + return keyParts.map(part => part).join(':'); } static splitKey(key){ diff --git a/commercial-paper/organization/digibank/contract/lib/paper.js b/commercial-paper/organization/digibank/contract/lib/paper.js index 18bccd5b..0629ba71 100644 --- a/commercial-paper/organization/digibank/contract/lib/paper.js +++ b/commercial-paper/organization/digibank/contract/lib/paper.js @@ -12,8 +12,9 @@ const State = require('./../ledger-api/state.js'); // Enumerate commercial paper state values const cpState = { ISSUED: 1, - TRADING: 2, - REDEEMED: 3 + PENDING: 2, + TRADING: 3, + REDEEMED: 4 }; /** @@ -42,6 +43,14 @@ class CommercialPaper extends State { return this.owner; } + setOwnerMSP(mspid) { + this.mspid = mspid; + } + + getOwnerMSP() { + return this.mspid; + } + setOwner(newOwner) { this.owner = newOwner; } @@ -61,6 +70,10 @@ class CommercialPaper extends State { this.currentState = cpState.REDEEMED; } + setPending() { + this.currentState = cpState.PENDING; + } + isIssued() { return this.currentState === cpState.ISSUED; } @@ -73,6 +86,10 @@ class CommercialPaper extends State { return this.currentState === cpState.REDEEMED; } + isPending() { + return this.currentState === cpState.PENDING; + } + static fromBuffer(buffer) { return CommercialPaper.deserialize(buffer); } diff --git a/commercial-paper/organization/digibank/contract/lib/papercontract.js b/commercial-paper/organization/digibank/contract/lib/papercontract.js index f995e112..c3d2cdb4 100644 --- a/commercial-paper/organization/digibank/contract/lib/papercontract.js +++ b/commercial-paper/organization/digibank/contract/lib/papercontract.js @@ -12,6 +12,7 @@ const { Contract, Context } = require('fabric-contract-api'); // PaperNet specifc classes const CommercialPaper = require('./paper.js'); const PaperList = require('./paperlist.js'); +const QueryUtils = require('./queries.js'); /** * A custom context provides easy access to list of all commercial papers @@ -67,12 +68,16 @@ class CommercialPaperContract extends Contract { async issue(ctx, issuer, paperNumber, issueDateTime, maturityDateTime, faceValue) { // create an instance of the paper - let paper = CommercialPaper.createInstance(issuer, paperNumber, issueDateTime, maturityDateTime, faceValue); + let paper = CommercialPaper.createInstance(issuer, paperNumber, issueDateTime, maturityDateTime, parseInt(faceValue)); // Smart contract, rather than paper, moves paper into ISSUED state paper.setIssued(); - // Newly issued paper is owned by the issuer + // save the owner's MSP + let mspid = ctx.clientIdentity.getMSPID(); + paper.setOwnerMSP(mspid); + + // Newly issued paper is owned by the issuer to begin with (recorded for reporting purposes) paper.setOwner(issuer); // Add the paper to the list of all similar commercial papers in the ledger world state @@ -85,14 +90,14 @@ class CommercialPaperContract extends Contract { /** * Buy commercial paper * - * @param {Context} ctx the transaction context - * @param {String} issuer commercial paper issuer - * @param {Integer} paperNumber paper number for this issuer - * @param {String} currentOwner current owner of paper - * @param {String} newOwner new owner of paper - * @param {Integer} price price paid for this paper - * @param {String} purchaseDateTime time paper was purchased (i.e. traded) - */ + * @param {Context} ctx the transaction context + * @param {String} issuer commercial paper issuer + * @param {Integer} paperNumber paper number for this issuer + * @param {String} currentOwner current owner of paper + * @param {String} newOwner new owner of paper + * @param {Integer} price price paid for this paper // transaction input - not written to asset + * @param {String} purchaseDateTime time paper was purchased (i.e. traded) // transaction input - not written to asset + */ async buy(ctx, issuer, paperNumber, currentOwner, newOwner, price, purchaseDateTime) { // Retrieve the current paper using key fields provided @@ -101,10 +106,10 @@ class CommercialPaperContract extends Contract { // Validate current owner if (paper.getOwner() !== currentOwner) { - throw new Error('Paper ' + issuer + paperNumber + ' is not owned by ' + currentOwner); + throw new Error('\nPaper ' + issuer + paperNumber + ' is not owned by ' + currentOwner); } - // First buy moves state from ISSUED to TRADING + // First buy moves state from ISSUED to TRADING (when running ) if (paper.isIssued()) { paper.setTrading(); } @@ -112,8 +117,11 @@ class CommercialPaperContract extends Contract { // Check paper is not already REDEEMED if (paper.isTrading()) { paper.setOwner(newOwner); + // save the owner's MSP + let mspid = ctx.clientIdentity.getMSPID(); + paper.setOwnerMSP(mspid); } else { - throw new Error('Paper ' + issuer + paperNumber + ' is not trading. Current state = ' + paper.getCurrentState()); + throw new Error('\nPaper ' + issuer + paperNumber + ' is not trading. Current state = ' + paper.getCurrentState()); } // Update the paper @@ -121,6 +129,79 @@ class CommercialPaperContract extends Contract { return paper; } + /** + * Buy request: (2-phase confirmation: Commercial paper is 'PENDING' subject to completion of transfer by owning org) + * Alternative to 'buy' transaction + * Note: 'buy_request' puts paper in 'PENDING' state - subject to transfer confirmation [below]. + * + * @param {Context} ctx the transaction context + * @param {String} issuer commercial paper issuer + * @param {Integer} paperNumber paper number for this issuer + * @param {String} currentOwner current owner of paper + * @param {String} newOwner new owner of paper // transaction input - not written to asset per se - but written to block + * @param {Integer} price price paid for this paper // transaction input - not written to asset per se - but written to block + * @param {String} purchaseDateTime time paper was requested // transaction input - ditto. + */ + async buy_request(ctx, issuer, paperNumber, currentOwner, newOwner, price, purchaseDateTime) { + + + // Retrieve the current paper using key fields provided + let paperKey = CommercialPaper.makeKey([issuer, paperNumber]); + let paper = await ctx.paperList.getPaper(paperKey); + + // Validate current owner - this is really information for the user trying the sample, rather than any 'authorisation' check per se FYI + if (paper.getOwner() !== currentOwner) { + throw new Error('\nPaper ' + issuer + paperNumber + ' is not owned by ' + currentOwner + ' provided as a paraneter'); + } + // paper set to 'PENDING' - can only be transferred (confirmed) by identity from owning org (MSP check). + paper.setPending(); + + // Update the paper + await ctx.paperList.updatePaper(paper); + return paper; + } + + /** + * transfer commercial paper: only the owning org has authority to execute. It is the complement to the 'buy_request' transaction. '[]' is optional below. + * eg. issue -> buy_request -> transfer -> [buy ...n | [buy_request...n | transfer ...n] ] -> redeem + * this transaction 'pair' is an alternative to the straight issue -> buy -> [buy....n] -> redeem ...path + * + * @param {Context} ctx the transaction context + * @param {String} issuer commercial paper issuer + * @param {Integer} paperNumber paper number for this issuer + * @param {String} newOwner new owner of paper + * @param {String} newOwnerMSP MSP id of the transferee + * @param {String} confirmDateTime confirmed transfer date. + */ + async transfer(ctx, issuer, paperNumber, newOwner, newOwnerMSP, confirmDateTime) { + + // Retrieve the current paper using key fields provided + let paperKey = CommercialPaper.makeKey([issuer, paperNumber]); + let paper = await ctx.paperList.getPaper(paperKey); + + // Validate current owner's MSP in the paper === invoking transferor's MSP id - can only transfer if you are the owning org. + + if (paper.getOwnerMSP() !== ctx.clientIdentity.getMSPID()) { + throw new Error('\nPaper ' + issuer + paperNumber + ' is not owned by the current invoking Organisation, and not authorised to transfer'); + } + + // Paper needs to be 'pending' - which means you need to have run 'buy_pending' transaction first. + if ( ! paper.isPending()) { + throw new Error('\nPaper ' + issuer + paperNumber + ' is not currently in state: PENDING for transfer to occur: \n must run buy_request transaction first'); + } + // else all good + + paper.setOwner(newOwner); + // set the MSP of the transferee (so that, that org may also pass MSP check, if subsequently transferred/sold on) + paper.setOwnerMSP(newOwnerMSP); + paper.setTrading(); + paper.confirmDateTime = confirmDateTime; + + // Update the paper + await ctx.paperList.updatePaper(paper); + return paper; + } + /** * Redeem commercial paper * @@ -128,31 +209,131 @@ class CommercialPaperContract extends Contract { * @param {String} issuer commercial paper issuer * @param {Integer} paperNumber paper number for this issuer * @param {String} redeemingOwner redeeming owner of paper + * @param {String} issuingOwnerMSP the MSP of the org that the paper will be redeemed with. * @param {String} redeemDateTime time paper was redeemed */ - async redeem(ctx, issuer, paperNumber, redeemingOwner, redeemDateTime) { + async redeem(ctx, issuer, paperNumber, redeemingOwner, issuingOwnerMSP, redeemDateTime) { let paperKey = CommercialPaper.makeKey([issuer, paperNumber]); let paper = await ctx.paperList.getPaper(paperKey); - // Check paper is not REDEEMED + // Check paper is not alread in a state of REDEEMED if (paper.isRedeemed()) { - throw new Error('Paper ' + issuer + paperNumber + ' already redeemed'); + throw new Error('\nPaper ' + issuer + paperNumber + ' has already been redeemed'); } - // Verify that the redeemer owns the commercial paper before redeeming it + // Validate current redeemer's MSP matches the invoking redeemer's MSP id - can only redeem if you are the owning org. + + if (paper.getOwnerMSP() !== ctx.clientIdentity.getMSPID()) { + throw new Error('\nPaper ' + issuer + paperNumber + ' cannot be redeemed by ' + ctx.clientIdentity.getMSPID() + ', as it is not the authorised owning Organisation'); + } + + // As this is just a sample, can show additional verification check: that the redeemer provided matches that on record, before redeeming it if (paper.getOwner() === redeemingOwner) { paper.setOwner(paper.getIssuer()); + paper.setOwnerMSP(issuingOwnerMSP); paper.setRedeemed(); + paper.redeemDateTime = redeemDateTime; // record redemption date against the asset (the complement to 'issue date') } else { - throw new Error('Redeeming owner does not own paper' + issuer + paperNumber); + throw new Error('\nRedeeming owner: ' + redeemingOwner + ' organisation does not currently own paper: ' + issuer + paperNumber); } await ctx.paperList.updatePaper(paper); return paper; } + // Query transactions + + /** + * Query history of a commercial paper + * @param {Context} ctx the transaction context + * @param {String} issuer commercial paper issuer + * @param {Integer} paperNumber paper number for this issuer + */ + async queryHistory(ctx, issuer, paperNumber) { + + // Get a key to be used for History query + + let query = new QueryUtils(ctx, 'org.papernet.paper'); + let results = await query.getAssetHistory(issuer, paperNumber); // (cpKey); + return results; + + } + + /** + * queryOwner commercial paper: supply name of owning org, to find list of papers based on owner field + * @param {Context} ctx the transaction context + * @param {String} owner commercial paper owner + */ + async queryOwner(ctx, owner) { + + let query = new QueryUtils(ctx, 'org.papernet.paper'); + let owner_results = await query.queryKeyByOwner(owner); + + return owner_results; + } + + /** + * queryPartial commercial paper - provide a prefix eg. "DigiBank" will list all papers _issued_ by DigiBank etc etc + * @param {Context} ctx the transaction context + * @param {String} prefix asset class prefix (added to paperlist namespace) eg. org.papernet.paperMagnetoCorp asset listing: papers issued by MagnetoCorp. + */ + async queryPartial(ctx, prefix) { + + let query = new QueryUtils(ctx, 'org.papernet.paper'); + let partial_results = await query.queryKeyByPartial(prefix); + + return partial_results; + } + + /** + * queryAdHoc commercial paper - supply a custom mango query + * eg - as supplied as a param: + * ex1: ["{\"selector\":{\"faceValue\":{\"$lt\":8000000}}}"] + * ex2: ["{\"selector\":{\"faceValue\":{\"$gt\":4999999}}}"] + * + * @param {Context} ctx the transaction context + * @param {String} queryString querystring + */ + async queryAdhoc(ctx, queryString) { + + let query = new QueryUtils(ctx, 'org.papernet.paper'); + let querySelector = JSON.parse(queryString); + let adhoc_results = await query.queryByAdhoc(querySelector); + + return adhoc_results; + } + + + /** + * queryNamed - supply named query - 'case' statement chooses selector to build (pre-canned for demo purposes) + * @param {Context} ctx the transaction context + * @param {String} queryname the 'named' query (built here) - or - the adHoc query string, provided as a parameter + */ + async queryNamed(ctx, queryname) { + let querySelector = {}; + switch (queryname) { + case "redeemed": + querySelector = { "selector": { "currentState": 4 } }; // 4 = redeemd state + break; + case "trading": + querySelector = { "selector": { "currentState": 3 } }; // 3 = trading state + break; + case "value": + // may change to provide as a param - fixed value for now in this sample + querySelector = { "selector": { "faceValue": { "$gt": 4000000 } } }; // to test, issue CommPapers with faceValue <= or => this figure. + break; + default: // else, unknown named query + throw new Error('invalid named query supplied: ' + queryname + '- please try again '); + } + + let query = new QueryUtils(ctx, 'org.papernet.paper'); + let adhoc_results = await query.queryByAdhoc(querySelector); + + return adhoc_results; + } + } module.exports = CommercialPaperContract; diff --git a/commercial-paper/organization/digibank/contract/lib/paperlist.js b/commercial-paper/organization/digibank/contract/lib/paperlist.js index 7d4a99aa..73528b61 100644 --- a/commercial-paper/organization/digibank/contract/lib/paperlist.js +++ b/commercial-paper/organization/digibank/contract/lib/paperlist.js @@ -14,7 +14,7 @@ const CommercialPaper = require('./paper.js'); class PaperList extends StateList { constructor(ctx) { - super(ctx, 'org.papernet.commercialpaperlist'); + super(ctx, 'org.papernet.paper'); this.use(CommercialPaper); } diff --git a/commercial-paper/organization/digibank/contract/lib/queries.js b/commercial-paper/organization/digibank/contract/lib/queries.js new file mode 100644 index 00000000..a7cd40ad --- /dev/null +++ b/commercial-paper/organization/digibank/contract/lib/queries.js @@ -0,0 +1,215 @@ + +/* +SPDX-License-Identifier: Apache-2.0 +*/ +'use strict'; + +const State = require('../ledger-api/state.js'); +//const CommercialPaper = require('./paper.js'); +/** + * Query Class for query functions such as history etc + * + */ +class QueryUtils { + + constructor(ctx, listName) { + this.ctx = ctx; + this.name = listName; + //this.supportedTypes = {}; + } + + // ========================================================================================= + // getAssetHistory takes the composite key as arg, gets returns results as JSON to 'main contract' + // ========================================================================================= + /** + * Get Asset History for a commercial paper + * @param {String} issuer the CP issuer + * @param {String} paperNumber commercial paper number + */ + async getAssetHistory(issuer, paperNumber) { + + let ledgerKey = await this.ctx.stub.createCompositeKey(this.name, [issuer, paperNumber]); + const resultsIterator = await this.ctx.stub.getHistoryForKey(ledgerKey); + let results = await this.getAllResults(resultsIterator, true); + + return results; + } + + // =========================================================================================== + // queryKeyByPartial performs a partial query based on the namespace and asset key prefix provided + + // Read-only function results are not typically submitted to ordering. If the read-only + // results are submitted to ordering, or if the query is used in an update transaction + // and submitted to ordering, then the committing peers will re-execute to guarantee that + // result sets are stable between endorsement time and commit time. The transaction is + // invalidated by the committing peers if the result set has changed between endorsement + // time and commit time. + // + // =========================================================================================== + /** + * queryOwner commercial paper + * @param {String} assetspace the asset space (eg MagnetoCorp's assets) + */ + async queryKeyByPartial(assetspace) { + + if (arguments.length < 1) { + throw new Error('Incorrect number of arguments. Expecting 1'); + } + // ie namespace + prefix to assets etc eg + // "Key":"org.papernet.paperMagnetoCorp0001" (0002, etc) + // "Partial":'org.papernet.paperlistMagnetoCorp"' (using partial key, find keys "0001", "0002" etc) + const resultsIterator = await this.ctx.stub.getStateByPartialCompositeKey(this.name, [assetspace]); + let method = this.getAllResults; + let results = await method(resultsIterator, false); + + return results; + } + + + // ===== Example: Parameterized rich query ================================================= + // queryKeyByOwner queries for assets based on a passed in owner. + // This is an example of a parameterized query accepting a single query parameter (owner). + // Only available on state databases that support rich query (e.g. CouchDB) + // ========================================================================================= + /** + * queryKeyByOwner commercial paper + * @param {String} owner commercial paper owner + */ + async queryKeyByOwner(owner) { + // + let self = this; + if (arguments.length < 1) { + throw new Error('Incorrect number of arguments. Expecting owner name.'); + } + let queryString = {}; + queryString.selector = {}; + // queryString.selector.docType = 'indexOwnerDoc'; + queryString.selector.owner = owner; + // set to (eg) '{selector:{owner:MagnetoCorp}}' + let method = self.getQueryResultForQueryString; + let queryResults = await method(this.ctx, self, JSON.stringify(queryString)); + return queryResults; + } + + // ===== Example: Ad hoc rich query ======================================================== + // queryAdhoc uses a query string to perform a query for marbles.. + // Query string matching state database syntax is passed in and executed as is. + // Supports ad hoc queries that can be defined at runtime by the client. + // If this is not desired, follow the queryKeyByOwner example for parameterized queries. + // Only available on state databases that support rich query (e.g. CouchDB) + // example passed using VS Code ext: ["{\"selector\": {\"owner\": \"MagnetoCorp\"}}"] + // ========================================================================================= + /** + * query By AdHoc string (commercial paper) + * @param {String} queryString actual MangoDB query string (escaped) + */ + async queryByAdhoc(queryString) { + + if (arguments.length < 1) { + throw new Error('Incorrect number of arguments. Expecting ad-hoc string, which gets stringified for mango query'); + } + let self = this; + + if (!queryString) { + throw new Error('queryString must not be empty'); + } + let method = self.getQueryResultForQueryString; + let queryResults = await method(this.ctx, self, JSON.stringify(queryString)); + return queryResults; + } + + // WORKER functions are below this line: these are called by the above functions, where iterator is passed in + + // ========================================================================================= + // getQueryResultForQueryString woerk function executes the passed-in query string. + // Result set is built and returned as a byte array containing the JSON results. + // ========================================================================================= + /** + * Function getQueryResultForQueryString + * @param {Context} ctx the transaction context + * @param {any} self within scope passed in + * @param {String} the query string created prior to calling this fn + */ + async getQueryResultForQueryString(ctx, self, queryString) { + + // console.log('- getQueryResultForQueryString queryString:\n' + queryString); + + const resultsIterator = await ctx.stub.getQueryResult(queryString); + let results = await self.getAllResults(resultsIterator, false); + + return results; + + } + + /** + * Function getAllResults + * @param {resultsIterator} iterator within scope passed in + * @param {Boolean} isHistory query string created prior to calling this fn + */ + async getAllResults(iterator, isHistory) { + let allResults = []; + let res = { done: false, value: null }; + + while (true) { + res = await iterator.next(); + let jsonRes = {}; + if (res.value && res.value.value.toString()) { + if (isHistory && isHistory === true) { + //jsonRes.TxId = res.value.tx_id; + jsonRes.TxId = res.value.txId; + jsonRes.Timestamp = res.value.timestamp; + jsonRes.Timestamp = new Date((res.value.timestamp.seconds.low * 1000)); + let ms = res.value.timestamp.nanos / 1000000; + jsonRes.Timestamp.setMilliseconds(ms); + if (res.value.is_delete) { + jsonRes.IsDelete = res.value.is_delete.toString(); + } else { + try { + jsonRes.Value = JSON.parse(res.value.value.toString('utf8')); + // report the commercial paper states during the asset lifecycle, just for asset history reporting + switch (jsonRes.Value.currentState) { + case 1: + jsonRes.Value.currentState = 'ISSUED'; + break; + case 2: + jsonRes.Value.currentState = 'PENDING'; + break; + case 3: + jsonRes.Value.currentState = 'TRADING'; + break; + case 4: + jsonRes.Value.currentState = 'REDEEMED'; + break; + default: // else, unknown named query + jsonRes.Value.currentState = 'UNKNOWN'; + } + + } catch (err) { + console.log(err); + jsonRes.Value = res.value.value.toString('utf8'); + } + } + } else { // non history query .. + jsonRes.Key = res.value.key; + try { + jsonRes.Record = JSON.parse(res.value.value.toString('utf8')); + } catch (err) { + console.log(err); + jsonRes.Record = res.value.value.toString('utf8'); + } + } + allResults.push(jsonRes); + } + // check to see if we have reached the end + if (res.done) { + // explicitly close the iterator + console.log('iterator is done'); + await iterator.close(); + return allResults; + } + + } // while true + } + +} +module.exports = QueryUtils; \ No newline at end of file diff --git a/commercial-paper/organization/magnetocorp/application/cpListener.js b/commercial-paper/organization/magnetocorp/application/cpListener.js new file mode 100644 index 00000000..78c8ba1f --- /dev/null +++ b/commercial-paper/organization/magnetocorp/application/cpListener.js @@ -0,0 +1,97 @@ +"use strict"; + +const yaml = require('js-yaml'); +const { Wallets, Gateway } = require('fabric-network'); +const path = require("path"); +const fs = require("fs"); + +let finished; +async function main() { + try { + // Set up the wallet - just use Org2's wallet (isabella) + const wallet = await Wallets.newFileSystemWallet('../identity/user/isabella/wallet'); + + // Create a new gateway for connecting to our peer node. + const gateway = new Gateway(); + + const userName = 'isabella'; + + // Load connection profile; will be used to locate a gateway + let connectionProfile = yaml.safeLoad(fs.readFileSync('../gateway/connection-org2.yaml', 'utf8')); + + // Set connection options; identity and wallet + let connectionOptions = { + identity: userName, + wallet: wallet, + discovery: { enabled:true, asLocalhost: true } + }; + + // connect to the gateway + await gateway.connect(connectionProfile, connectionOptions); + // get the channel and smart contract + const network = await gateway.getNetwork('mychannel'); + + // Listen for blocks being added, display relevant contents: in particular, the transaction inputs + finished = false; + + const listener = async (event) => { + if (event.blockData !== undefined) { + for (const i in event.blockData.data.data) { + if (event.blockData.data.data[i].payload.data.actions !== undefined) { + const inputArgs = event.blockData.data.data[i].payload.data.actions[0].payload.chaincode_proposal_payload.input.chaincode_spec.input.args; + // Print block details + console.log('----------'); + console.log('Block:', parseInt(event.blockData.header.number), 'transaction', i); + // Show ID and timestamp of the transaction + const tx_id = event.blockData.data.data[i].payload.header.channel_header.tx_id; + const txTime = new Date(event.blockData.data.data[i].payload.header.channel_header.timestamp).toUTCString(); + // Show ID, date and time of transaction + console.log('Transaction ID:', tx_id); + console.log('Timestamp:', txTime); + // Show transaction inputs (formatted, as may contain binary data) + let inputData = 'Inputs: '; + for (let j = 0; j < inputArgs.length; j++) { + const inputArgPrintable = inputArgs[j].toString().replace(/[^\x20-\x7E]+/g, ''); + inputData = inputData.concat(inputArgPrintable, ' '); + } + console.log(inputData); + // Show the proposed writes to the world state + let keyData = 'Keys updated: '; + for (const l in event.blockData.data.data[i].payload.data.actions[0].payload.action.proposal_response_payload.extension.results.ns_rwset[1].rwset.writes) { + // add a ' ' space between multiple keys in 'concat' + keyData = keyData.concat(event.blockData.data.data[i].payload.data.actions[0].payload.action.proposal_response_payload.extension.results.ns_rwset[1].rwset.writes[l].key, ' '); + } + console.log(keyData); + // Show which organizations endorsed + let endorsers = 'Endorsers: '; + for (const k in event.blockData.data.data[i].payload.data.actions[0].payload.action.endorsements) { + endorsers = endorsers.concat(event.blockData.data.data[i].payload.data.actions[0].payload.action.endorsements[k].endorser.mspid, ' '); + } + console.log(endorsers); + // Was the transaction valid or not? + // (Invalid transactions are still logged on the blockchain but don't affect the world state) + if ((event.blockData.metadata.metadata[2])[i] !== 0) { + console.log('INVALID TRANSACTION'); + } + } + } + } + }; + const options = { + type: 'full', + startBlock: 1 + }; + await network.addBlockListener(listener, options); + while (!finished) { + await new Promise(resolve => setTimeout(resolve, 5000)); + // Disconnect from the gateway after Promise is resolved. + // ... do other things + } + gateway.disconnect(); + } + catch (error) { + console.error('Error: ', error); + process.exit(1); + } +} +void main(); diff --git a/commercial-paper/organization/magnetocorp/application/transfer.js b/commercial-paper/organization/magnetocorp/application/transfer.js new file mode 100644 index 00000000..908903ab --- /dev/null +++ b/commercial-paper/organization/magnetocorp/application/transfer.js @@ -0,0 +1,103 @@ +/* + * Copyright IBM Corp. All Rights Reserved. + * + * SPDX-License-Identifier: Apache-2.0 +*/ + +/* + * This application has 6 basic steps: + * 1. Select an identity from a wallet + * 2. Connect to network gateway + * 3. Access PaperNet network + * 4. Construct request to transfer commercial paper + * 5. Submit transaction + * 6. Process response + */ + +'use strict'; + +// Bring key classes into scope, most importantly Fabric SDK network class +const fs = require('fs'); +const yaml = require('js-yaml'); +const { Wallets, Gateway } = require('fabric-network'); +const CommercialPaper = require('../contract/lib/paper.js'); + +// Main program function +async function main() { + + // A wallet stores a collection of identities for use + const wallet = await Wallets.newFileSystemWallet('../identity/user/isabella/wallet'); + + // A gateway defines the peers used to access Fabric networks + const gateway = new Gateway(); + + // Main try/catch block + try { + + // Specify userName for network access + // const userName = 'isabella.issuer@magnetocorp.com'; + const userName = 'isabella'; + + // Load connection profile; will be used to locate a gateway + let connectionProfile = yaml.safeLoad(fs.readFileSync('../gateway/connection-org2.yaml', 'utf8')); + + // Set connection options; identity and wallet + let connectionOptions = { + identity: userName, + wallet: wallet, + discovery: { enabled:true, asLocalhost: true } + }; + + // Connect to gateway using application specified parameters + console.log('Connect to Fabric gateway.'); + + await gateway.connect(connectionProfile, connectionOptions); + + // Access PaperNet network + console.log('Use network channel: mychannel.'); + + const network = await gateway.getNetwork('mychannel'); + + // Get addressability to commercial paper contract + console.log('Use org.papernet.commercialpaper smart contract.'); + + const contract = await network.getContract('papercontract'); + + // transfer commercial paper + console.log('Submit commercial paper transfer transaction.'); + + const transferResponse = await contract.submitTransaction('transfer', 'MagnetoCorp', '00001', 'DigiBank', 'Org1MSP', '2020-06-01'); + + // process response + console.log('Process transfer transaction response.'+ transferResponse); + + let paper = CommercialPaper.fromBuffer(transferResponse); + + console.log(`commercial paper issued by ${paper.issuer} : ${paper.paperNumber} was successfully transferred`); + console.log('Transaction complete.'); + + } catch (error) { + + console.log(`Error processing transaction. ${error}`); + console.log(error.stack); + + } finally { + + // Disconnect from the gateway + console.log('Disconnect from Fabric gateway.'); + gateway.disconnect(); + + } +} +main().then(() => { + + console.log('Transfer program complete.'); + +}).catch((e) => { + + console.log('Transfer program exception.'); + console.log(e); + console.log(e.stack); + process.exit(-1); + +}); diff --git a/commercial-paper/organization/magnetocorp/contract/ledger-api/state.js b/commercial-paper/organization/magnetocorp/contract/ledger-api/state.js index a2f92273..f63e792e 100644 --- a/commercial-paper/organization/magnetocorp/contract/ledger-api/state.js +++ b/commercial-paper/organization/magnetocorp/contract/ledger-api/state.js @@ -38,9 +38,11 @@ class State { return this.currentState; } - serialize() { + // not used +/* serialize() { + return State.serialize(this); - } + } */ /** * Convert object to buffer containing JSON data serialization @@ -49,6 +51,8 @@ class State { * @return {buffer} buffer with the data to store */ static serialize(object) { + // don't write the key:value passed in - we already have a real composite key, issuer and paper Number. + delete object.key; return Buffer.from(JSON.stringify(object)); } @@ -88,7 +92,8 @@ class State { * @param (String[]) keyParts */ static makeKey(keyParts) { - return keyParts.map(part => JSON.stringify(part)).join(':'); + // return keyParts.map(part => JSON.stringify(part)).join(':'); + return keyParts.map(part => part).join(':'); } static splitKey(key){ diff --git a/commercial-paper/organization/magnetocorp/contract/lib/paper.js b/commercial-paper/organization/magnetocorp/contract/lib/paper.js index 18bccd5b..0629ba71 100644 --- a/commercial-paper/organization/magnetocorp/contract/lib/paper.js +++ b/commercial-paper/organization/magnetocorp/contract/lib/paper.js @@ -12,8 +12,9 @@ const State = require('./../ledger-api/state.js'); // Enumerate commercial paper state values const cpState = { ISSUED: 1, - TRADING: 2, - REDEEMED: 3 + PENDING: 2, + TRADING: 3, + REDEEMED: 4 }; /** @@ -42,6 +43,14 @@ class CommercialPaper extends State { return this.owner; } + setOwnerMSP(mspid) { + this.mspid = mspid; + } + + getOwnerMSP() { + return this.mspid; + } + setOwner(newOwner) { this.owner = newOwner; } @@ -61,6 +70,10 @@ class CommercialPaper extends State { this.currentState = cpState.REDEEMED; } + setPending() { + this.currentState = cpState.PENDING; + } + isIssued() { return this.currentState === cpState.ISSUED; } @@ -73,6 +86,10 @@ class CommercialPaper extends State { return this.currentState === cpState.REDEEMED; } + isPending() { + return this.currentState === cpState.PENDING; + } + static fromBuffer(buffer) { return CommercialPaper.deserialize(buffer); } diff --git a/commercial-paper/organization/magnetocorp/contract/lib/papercontract.js b/commercial-paper/organization/magnetocorp/contract/lib/papercontract.js index 3eb4af6e..c3d2cdb4 100644 --- a/commercial-paper/organization/magnetocorp/contract/lib/papercontract.js +++ b/commercial-paper/organization/magnetocorp/contract/lib/papercontract.js @@ -12,6 +12,7 @@ const { Contract, Context } = require('fabric-contract-api'); // PaperNet specifc classes const CommercialPaper = require('./paper.js'); const PaperList = require('./paperlist.js'); +const QueryUtils = require('./queries.js'); /** * A custom context provides easy access to list of all commercial papers @@ -67,12 +68,16 @@ class CommercialPaperContract extends Contract { async issue(ctx, issuer, paperNumber, issueDateTime, maturityDateTime, faceValue) { // create an instance of the paper - let paper = CommercialPaper.createInstance(issuer, paperNumber, issueDateTime, maturityDateTime, faceValue); + let paper = CommercialPaper.createInstance(issuer, paperNumber, issueDateTime, maturityDateTime, parseInt(faceValue)); // Smart contract, rather than paper, moves paper into ISSUED state paper.setIssued(); - // Newly issued paper is owned by the issuer + // save the owner's MSP + let mspid = ctx.clientIdentity.getMSPID(); + paper.setOwnerMSP(mspid); + + // Newly issued paper is owned by the issuer to begin with (recorded for reporting purposes) paper.setOwner(issuer); // Add the paper to the list of all similar commercial papers in the ledger world state @@ -85,14 +90,14 @@ class CommercialPaperContract extends Contract { /** * Buy commercial paper * - * @param {Context} ctx the transaction context - * @param {String} issuer commercial paper issuer - * @param {Integer} paperNumber paper number for this issuer - * @param {String} currentOwner current owner of paper - * @param {String} newOwner new owner of paper - * @param {Integer} price price paid for this paper - * @param {String} purchaseDateTime time paper was purchased (i.e. traded) - */ + * @param {Context} ctx the transaction context + * @param {String} issuer commercial paper issuer + * @param {Integer} paperNumber paper number for this issuer + * @param {String} currentOwner current owner of paper + * @param {String} newOwner new owner of paper + * @param {Integer} price price paid for this paper // transaction input - not written to asset + * @param {String} purchaseDateTime time paper was purchased (i.e. traded) // transaction input - not written to asset + */ async buy(ctx, issuer, paperNumber, currentOwner, newOwner, price, purchaseDateTime) { // Retrieve the current paper using key fields provided @@ -101,10 +106,10 @@ class CommercialPaperContract extends Contract { // Validate current owner if (paper.getOwner() !== currentOwner) { - throw new Error('Paper ' + issuer + paperNumber + ' is not owned by ' + currentOwner); + throw new Error('\nPaper ' + issuer + paperNumber + ' is not owned by ' + currentOwner); } - // First buy moves state from ISSUED to TRADING + // First buy moves state from ISSUED to TRADING (when running ) if (paper.isIssued()) { paper.setTrading(); } @@ -112,8 +117,11 @@ class CommercialPaperContract extends Contract { // Check paper is not already REDEEMED if (paper.isTrading()) { paper.setOwner(newOwner); + // save the owner's MSP + let mspid = ctx.clientIdentity.getMSPID(); + paper.setOwnerMSP(mspid); } else { - throw new Error('Paper ' + issuer + paperNumber + ' is not trading. Current state = ' +paper.getCurrentState()); + throw new Error('\nPaper ' + issuer + paperNumber + ' is not trading. Current state = ' + paper.getCurrentState()); } // Update the paper @@ -121,6 +129,79 @@ class CommercialPaperContract extends Contract { return paper; } + /** + * Buy request: (2-phase confirmation: Commercial paper is 'PENDING' subject to completion of transfer by owning org) + * Alternative to 'buy' transaction + * Note: 'buy_request' puts paper in 'PENDING' state - subject to transfer confirmation [below]. + * + * @param {Context} ctx the transaction context + * @param {String} issuer commercial paper issuer + * @param {Integer} paperNumber paper number for this issuer + * @param {String} currentOwner current owner of paper + * @param {String} newOwner new owner of paper // transaction input - not written to asset per se - but written to block + * @param {Integer} price price paid for this paper // transaction input - not written to asset per se - but written to block + * @param {String} purchaseDateTime time paper was requested // transaction input - ditto. + */ + async buy_request(ctx, issuer, paperNumber, currentOwner, newOwner, price, purchaseDateTime) { + + + // Retrieve the current paper using key fields provided + let paperKey = CommercialPaper.makeKey([issuer, paperNumber]); + let paper = await ctx.paperList.getPaper(paperKey); + + // Validate current owner - this is really information for the user trying the sample, rather than any 'authorisation' check per se FYI + if (paper.getOwner() !== currentOwner) { + throw new Error('\nPaper ' + issuer + paperNumber + ' is not owned by ' + currentOwner + ' provided as a paraneter'); + } + // paper set to 'PENDING' - can only be transferred (confirmed) by identity from owning org (MSP check). + paper.setPending(); + + // Update the paper + await ctx.paperList.updatePaper(paper); + return paper; + } + + /** + * transfer commercial paper: only the owning org has authority to execute. It is the complement to the 'buy_request' transaction. '[]' is optional below. + * eg. issue -> buy_request -> transfer -> [buy ...n | [buy_request...n | transfer ...n] ] -> redeem + * this transaction 'pair' is an alternative to the straight issue -> buy -> [buy....n] -> redeem ...path + * + * @param {Context} ctx the transaction context + * @param {String} issuer commercial paper issuer + * @param {Integer} paperNumber paper number for this issuer + * @param {String} newOwner new owner of paper + * @param {String} newOwnerMSP MSP id of the transferee + * @param {String} confirmDateTime confirmed transfer date. + */ + async transfer(ctx, issuer, paperNumber, newOwner, newOwnerMSP, confirmDateTime) { + + // Retrieve the current paper using key fields provided + let paperKey = CommercialPaper.makeKey([issuer, paperNumber]); + let paper = await ctx.paperList.getPaper(paperKey); + + // Validate current owner's MSP in the paper === invoking transferor's MSP id - can only transfer if you are the owning org. + + if (paper.getOwnerMSP() !== ctx.clientIdentity.getMSPID()) { + throw new Error('\nPaper ' + issuer + paperNumber + ' is not owned by the current invoking Organisation, and not authorised to transfer'); + } + + // Paper needs to be 'pending' - which means you need to have run 'buy_pending' transaction first. + if ( ! paper.isPending()) { + throw new Error('\nPaper ' + issuer + paperNumber + ' is not currently in state: PENDING for transfer to occur: \n must run buy_request transaction first'); + } + // else all good + + paper.setOwner(newOwner); + // set the MSP of the transferee (so that, that org may also pass MSP check, if subsequently transferred/sold on) + paper.setOwnerMSP(newOwnerMSP); + paper.setTrading(); + paper.confirmDateTime = confirmDateTime; + + // Update the paper + await ctx.paperList.updatePaper(paper); + return paper; + } + /** * Redeem commercial paper * @@ -128,31 +209,131 @@ class CommercialPaperContract extends Contract { * @param {String} issuer commercial paper issuer * @param {Integer} paperNumber paper number for this issuer * @param {String} redeemingOwner redeeming owner of paper + * @param {String} issuingOwnerMSP the MSP of the org that the paper will be redeemed with. * @param {String} redeemDateTime time paper was redeemed */ - async redeem(ctx, issuer, paperNumber, redeemingOwner, redeemDateTime) { + async redeem(ctx, issuer, paperNumber, redeemingOwner, issuingOwnerMSP, redeemDateTime) { let paperKey = CommercialPaper.makeKey([issuer, paperNumber]); let paper = await ctx.paperList.getPaper(paperKey); - // Check paper is not REDEEMED + // Check paper is not alread in a state of REDEEMED if (paper.isRedeemed()) { - throw new Error('Paper ' + issuer + paperNumber + ' already redeemed'); + throw new Error('\nPaper ' + issuer + paperNumber + ' has already been redeemed'); } - // Verify that the redeemer owns the commercial paper before redeeming it + // Validate current redeemer's MSP matches the invoking redeemer's MSP id - can only redeem if you are the owning org. + + if (paper.getOwnerMSP() !== ctx.clientIdentity.getMSPID()) { + throw new Error('\nPaper ' + issuer + paperNumber + ' cannot be redeemed by ' + ctx.clientIdentity.getMSPID() + ', as it is not the authorised owning Organisation'); + } + + // As this is just a sample, can show additional verification check: that the redeemer provided matches that on record, before redeeming it if (paper.getOwner() === redeemingOwner) { paper.setOwner(paper.getIssuer()); + paper.setOwnerMSP(issuingOwnerMSP); paper.setRedeemed(); + paper.redeemDateTime = redeemDateTime; // record redemption date against the asset (the complement to 'issue date') } else { - throw new Error('Redeeming owner does not own paper' + issuer + paperNumber); + throw new Error('\nRedeeming owner: ' + redeemingOwner + ' organisation does not currently own paper: ' + issuer + paperNumber); } await ctx.paperList.updatePaper(paper); return paper; } + // Query transactions + + /** + * Query history of a commercial paper + * @param {Context} ctx the transaction context + * @param {String} issuer commercial paper issuer + * @param {Integer} paperNumber paper number for this issuer + */ + async queryHistory(ctx, issuer, paperNumber) { + + // Get a key to be used for History query + + let query = new QueryUtils(ctx, 'org.papernet.paper'); + let results = await query.getAssetHistory(issuer, paperNumber); // (cpKey); + return results; + + } + + /** + * queryOwner commercial paper: supply name of owning org, to find list of papers based on owner field + * @param {Context} ctx the transaction context + * @param {String} owner commercial paper owner + */ + async queryOwner(ctx, owner) { + + let query = new QueryUtils(ctx, 'org.papernet.paper'); + let owner_results = await query.queryKeyByOwner(owner); + + return owner_results; + } + + /** + * queryPartial commercial paper - provide a prefix eg. "DigiBank" will list all papers _issued_ by DigiBank etc etc + * @param {Context} ctx the transaction context + * @param {String} prefix asset class prefix (added to paperlist namespace) eg. org.papernet.paperMagnetoCorp asset listing: papers issued by MagnetoCorp. + */ + async queryPartial(ctx, prefix) { + + let query = new QueryUtils(ctx, 'org.papernet.paper'); + let partial_results = await query.queryKeyByPartial(prefix); + + return partial_results; + } + + /** + * queryAdHoc commercial paper - supply a custom mango query + * eg - as supplied as a param: + * ex1: ["{\"selector\":{\"faceValue\":{\"$lt\":8000000}}}"] + * ex2: ["{\"selector\":{\"faceValue\":{\"$gt\":4999999}}}"] + * + * @param {Context} ctx the transaction context + * @param {String} queryString querystring + */ + async queryAdhoc(ctx, queryString) { + + let query = new QueryUtils(ctx, 'org.papernet.paper'); + let querySelector = JSON.parse(queryString); + let adhoc_results = await query.queryByAdhoc(querySelector); + + return adhoc_results; + } + + + /** + * queryNamed - supply named query - 'case' statement chooses selector to build (pre-canned for demo purposes) + * @param {Context} ctx the transaction context + * @param {String} queryname the 'named' query (built here) - or - the adHoc query string, provided as a parameter + */ + async queryNamed(ctx, queryname) { + let querySelector = {}; + switch (queryname) { + case "redeemed": + querySelector = { "selector": { "currentState": 4 } }; // 4 = redeemd state + break; + case "trading": + querySelector = { "selector": { "currentState": 3 } }; // 3 = trading state + break; + case "value": + // may change to provide as a param - fixed value for now in this sample + querySelector = { "selector": { "faceValue": { "$gt": 4000000 } } }; // to test, issue CommPapers with faceValue <= or => this figure. + break; + default: // else, unknown named query + throw new Error('invalid named query supplied: ' + queryname + '- please try again '); + } + + let query = new QueryUtils(ctx, 'org.papernet.paper'); + let adhoc_results = await query.queryByAdhoc(querySelector); + + return adhoc_results; + } + } module.exports = CommercialPaperContract; diff --git a/commercial-paper/organization/magnetocorp/contract/lib/paperlist.js b/commercial-paper/organization/magnetocorp/contract/lib/paperlist.js index 7d4a99aa..73528b61 100644 --- a/commercial-paper/organization/magnetocorp/contract/lib/paperlist.js +++ b/commercial-paper/organization/magnetocorp/contract/lib/paperlist.js @@ -14,7 +14,7 @@ const CommercialPaper = require('./paper.js'); class PaperList extends StateList { constructor(ctx) { - super(ctx, 'org.papernet.commercialpaperlist'); + super(ctx, 'org.papernet.paper'); this.use(CommercialPaper); } diff --git a/commercial-paper/organization/magnetocorp/contract/lib/queries.js b/commercial-paper/organization/magnetocorp/contract/lib/queries.js new file mode 100644 index 00000000..a7cd40ad --- /dev/null +++ b/commercial-paper/organization/magnetocorp/contract/lib/queries.js @@ -0,0 +1,215 @@ + +/* +SPDX-License-Identifier: Apache-2.0 +*/ +'use strict'; + +const State = require('../ledger-api/state.js'); +//const CommercialPaper = require('./paper.js'); +/** + * Query Class for query functions such as history etc + * + */ +class QueryUtils { + + constructor(ctx, listName) { + this.ctx = ctx; + this.name = listName; + //this.supportedTypes = {}; + } + + // ========================================================================================= + // getAssetHistory takes the composite key as arg, gets returns results as JSON to 'main contract' + // ========================================================================================= + /** + * Get Asset History for a commercial paper + * @param {String} issuer the CP issuer + * @param {String} paperNumber commercial paper number + */ + async getAssetHistory(issuer, paperNumber) { + + let ledgerKey = await this.ctx.stub.createCompositeKey(this.name, [issuer, paperNumber]); + const resultsIterator = await this.ctx.stub.getHistoryForKey(ledgerKey); + let results = await this.getAllResults(resultsIterator, true); + + return results; + } + + // =========================================================================================== + // queryKeyByPartial performs a partial query based on the namespace and asset key prefix provided + + // Read-only function results are not typically submitted to ordering. If the read-only + // results are submitted to ordering, or if the query is used in an update transaction + // and submitted to ordering, then the committing peers will re-execute to guarantee that + // result sets are stable between endorsement time and commit time. The transaction is + // invalidated by the committing peers if the result set has changed between endorsement + // time and commit time. + // + // =========================================================================================== + /** + * queryOwner commercial paper + * @param {String} assetspace the asset space (eg MagnetoCorp's assets) + */ + async queryKeyByPartial(assetspace) { + + if (arguments.length < 1) { + throw new Error('Incorrect number of arguments. Expecting 1'); + } + // ie namespace + prefix to assets etc eg + // "Key":"org.papernet.paperMagnetoCorp0001" (0002, etc) + // "Partial":'org.papernet.paperlistMagnetoCorp"' (using partial key, find keys "0001", "0002" etc) + const resultsIterator = await this.ctx.stub.getStateByPartialCompositeKey(this.name, [assetspace]); + let method = this.getAllResults; + let results = await method(resultsIterator, false); + + return results; + } + + + // ===== Example: Parameterized rich query ================================================= + // queryKeyByOwner queries for assets based on a passed in owner. + // This is an example of a parameterized query accepting a single query parameter (owner). + // Only available on state databases that support rich query (e.g. CouchDB) + // ========================================================================================= + /** + * queryKeyByOwner commercial paper + * @param {String} owner commercial paper owner + */ + async queryKeyByOwner(owner) { + // + let self = this; + if (arguments.length < 1) { + throw new Error('Incorrect number of arguments. Expecting owner name.'); + } + let queryString = {}; + queryString.selector = {}; + // queryString.selector.docType = 'indexOwnerDoc'; + queryString.selector.owner = owner; + // set to (eg) '{selector:{owner:MagnetoCorp}}' + let method = self.getQueryResultForQueryString; + let queryResults = await method(this.ctx, self, JSON.stringify(queryString)); + return queryResults; + } + + // ===== Example: Ad hoc rich query ======================================================== + // queryAdhoc uses a query string to perform a query for marbles.. + // Query string matching state database syntax is passed in and executed as is. + // Supports ad hoc queries that can be defined at runtime by the client. + // If this is not desired, follow the queryKeyByOwner example for parameterized queries. + // Only available on state databases that support rich query (e.g. CouchDB) + // example passed using VS Code ext: ["{\"selector\": {\"owner\": \"MagnetoCorp\"}}"] + // ========================================================================================= + /** + * query By AdHoc string (commercial paper) + * @param {String} queryString actual MangoDB query string (escaped) + */ + async queryByAdhoc(queryString) { + + if (arguments.length < 1) { + throw new Error('Incorrect number of arguments. Expecting ad-hoc string, which gets stringified for mango query'); + } + let self = this; + + if (!queryString) { + throw new Error('queryString must not be empty'); + } + let method = self.getQueryResultForQueryString; + let queryResults = await method(this.ctx, self, JSON.stringify(queryString)); + return queryResults; + } + + // WORKER functions are below this line: these are called by the above functions, where iterator is passed in + + // ========================================================================================= + // getQueryResultForQueryString woerk function executes the passed-in query string. + // Result set is built and returned as a byte array containing the JSON results. + // ========================================================================================= + /** + * Function getQueryResultForQueryString + * @param {Context} ctx the transaction context + * @param {any} self within scope passed in + * @param {String} the query string created prior to calling this fn + */ + async getQueryResultForQueryString(ctx, self, queryString) { + + // console.log('- getQueryResultForQueryString queryString:\n' + queryString); + + const resultsIterator = await ctx.stub.getQueryResult(queryString); + let results = await self.getAllResults(resultsIterator, false); + + return results; + + } + + /** + * Function getAllResults + * @param {resultsIterator} iterator within scope passed in + * @param {Boolean} isHistory query string created prior to calling this fn + */ + async getAllResults(iterator, isHistory) { + let allResults = []; + let res = { done: false, value: null }; + + while (true) { + res = await iterator.next(); + let jsonRes = {}; + if (res.value && res.value.value.toString()) { + if (isHistory && isHistory === true) { + //jsonRes.TxId = res.value.tx_id; + jsonRes.TxId = res.value.txId; + jsonRes.Timestamp = res.value.timestamp; + jsonRes.Timestamp = new Date((res.value.timestamp.seconds.low * 1000)); + let ms = res.value.timestamp.nanos / 1000000; + jsonRes.Timestamp.setMilliseconds(ms); + if (res.value.is_delete) { + jsonRes.IsDelete = res.value.is_delete.toString(); + } else { + try { + jsonRes.Value = JSON.parse(res.value.value.toString('utf8')); + // report the commercial paper states during the asset lifecycle, just for asset history reporting + switch (jsonRes.Value.currentState) { + case 1: + jsonRes.Value.currentState = 'ISSUED'; + break; + case 2: + jsonRes.Value.currentState = 'PENDING'; + break; + case 3: + jsonRes.Value.currentState = 'TRADING'; + break; + case 4: + jsonRes.Value.currentState = 'REDEEMED'; + break; + default: // else, unknown named query + jsonRes.Value.currentState = 'UNKNOWN'; + } + + } catch (err) { + console.log(err); + jsonRes.Value = res.value.value.toString('utf8'); + } + } + } else { // non history query .. + jsonRes.Key = res.value.key; + try { + jsonRes.Record = JSON.parse(res.value.value.toString('utf8')); + } catch (err) { + console.log(err); + jsonRes.Record = res.value.value.toString('utf8'); + } + } + allResults.push(jsonRes); + } + // check to see if we have reached the end + if (res.done) { + // explicitly close the iterator + console.log('iterator is done'); + await iterator.close(); + return allResults; + } + + } // while true + } + +} +module.exports = QueryUtils; \ No newline at end of file