This application is a demonstration of how a commercial paper trading network might be implemented on IBM Blockchain. The components of the demo are:

• An interface for creating new users on the network.
• An interface for creating new commercial papers to trade.
• A Trade Center for buying and selling existing trades.
• A special interface just for auditors of the network to examine trades

1. Deploy the demo to your IBM Bluemix account using the button above.

1. Clone this repository.
2. Create an instance of the IBM Blockchain service in the Bluemix catalog.
3. Copy the credentials from the service into the file 'my_creds.json'.
4. Make sure the key/value store only has values for your current network (See below).
5. Comment out the following line in app.js: process.env.GOPATH = __dirname;
6. Copy the ./src/chain_code folder of this repository to the $GOPATH/src/ folder on your machine.
7. Run these commands in the cloned directory:

npm install
gulp

These credentials can be obtained from the "Service Credentials" tab of the Bluemix service. They are in the form:

{
  "credentials": {
    "peers": [
      {
        "discovery_host": "169.53.62.121",
        "discovery_port": "40275",
        "api_host": "169.53.62.121",
        "api_port": "40276",
        "type": "peer",
        "network_id": "4b21f2f9-4d10-4946-a0df-f91ac09dbc03",
        "id": "4b21f2f9-4d10-4946-a0df-f91ac09dbc03_vp1",
        "api_url": "http://169.53.62.121:40276"
      }
    ],
    "users": [
      {
        "username": "user_type0_b7c7a1e545",
        "secret": "89ce33e4e6"
      }
    ]
  }
}

1. Register some users using the registration form on the login page.
2. Save the credentials that are created for the users you register. They appear just above the registration form.
3. Use the credentials to log in to the application. The UI you see will be determined by the role that was assigned to each user.
4. Open the 'CREATE' tab to create new trades.
5. Open the 'TRADE' tab to participate in your commercial paper trading network.
6. Open the 'AUDIT' tab to view all of the trades on the network.

When the fabric SDK is used to enroll users, the enrollment certificate for the user is downloaded from the CA and the secret for the user you enrolled is invalidated. Basically, nobody will be able to enroll the user again. By default, the SDK will download this certificate into a local key value store. So, the only apps that will be able to use the enrolled users are those that have access to the enrollment certificate.

When this demo is initialized, it attempts to enroll one of the blockchain networks registrar users, WebAppAdmin, downloading the enrollment certificate for that user into the demo applications filesystem on Bluemix. This will prevent other demos or apps on that network from being able to use the WebAppAdmin user. The message to take away from all of this is that you should only use this demo on it's own blockchain network, for now.

• Passwords don't mean anything in the demo. We're working on it. You still need to register users to interact with the demo, but you can use anything in the password field to log in.

• Having the string 'auditor' in the username will cause the user to be registered as an auditor, while anything else will register the user as a regular user, meaning that they can create and trade paper. These limitations will be fixed in future versions of the demo.

• Nothing happens when papers mature.

• For now, the permissions for auditors and regular users are only enforced within the web application. An updated user architecture will be coming to the fabric to fix this in the future.

This web application includes code to track deployments to IBM Bluemix and other Cloud Foundry platforms. The following information is sent to a Deployment Tracker service on each deployment:

• Application Name (application_name)
• Space ID (space_id)
• Application Version (application_version)
• Application URIs (application_uris)

This data is collected from the VCAP_APPLICATION environment variable in IBM Bluemix and other Cloud Foundry platforms. This data is used by IBM to track metrics around deployments of sample applications to IBM Bluemix to measure the usefulness of our examples, so that we can continuously improve the content we offer to you. Only deployments of sample applications that include code to ping the Deployment Tracker service will be tracked.

Deployment tracking can be disabled by deleting the following code in app.js:

// Track the application deployments
require("cf-deployment-tracker-client").track();