2016-11-18 17:51:12 +00:00
|
|
|
# Bank of Corda demo
|
|
|
|
|
Please see docs/build/html/running-the-demos.html
|
|
|
|
|
|
|
|
|
|
This program simulates the role of an asset issuing authority (eg. central bank for cash) by accepting requests
|
|
|
|
|
from third parties to issue some quantity of an asset and transfer that ownership to the requester.
|
|
|
|
|
The issuing authority accepts requests via the [IssuerFlow] flow, self-issues the asset and transfers
|
|
|
|
|
ownership to the issue requester. Notarisation and signing form part of the flow.
|
|
|
|
|
|
|
|
|
|
The requesting party can be a CorDapp (running locally or remotely to the Bank of Corda node), a remote RPC client or
|
|
|
|
|
a Web Client.
|
|
|
|
|
|
|
|
|
|
## Prerequisites
|
|
|
|
|
|
|
|
|
|
You will need to have [JDK 8](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html)
|
|
|
|
|
installed and available on your path.
|
|
|
|
|
|
|
|
|
|
## Getting Started
|
|
|
|
|
|
|
|
|
|
1. Launch the Bank of Corda node (and associated Notary) by running:
|
|
|
|
|
[BankOfCordaDriver] --role ISSUER
|
|
|
|
|
(to validate your Node is running you can try navigating to this sample link: http://localhost:10005/api/bank/date)
|
|
|
|
|
|
|
|
|
|
Each of the following commands will launch a separate Node called Big Corporation which will become the owner
|
|
|
|
|
of some Cash following an issue request:
|
|
|
|
|
|
|
|
|
|
2. Run the Bank of Corda Client driver (to simulate a web issue requester) by running:
|
|
|
|
|
[BankOfCordaDriver] --role ISSUE_CASH_WEB
|
|
|
|
|
This demonstrates a remote application acting on behalf of the Big Corporation and communicating directly with the
|
|
|
|
|
Bank of Corda node via HTTP to request issuance of some cash.
|
|
|
|
|
|
|
|
|
|
3. Run the Bank of Corda Client driver (to simulate an RPC issue requester) by running:
|
|
|
|
|
[BankOfCordaDriver] --role ISSUE_CASH_RPC
|
|
|
|
|
Similar to 3 above, but using RPC as the remote communications mechanism.
|
|
|
|
|
|
|
|
|
|
## Developer notes
|
|
|
|
|
|
|
|
|
|
Testing of the Bank of Corda application is demonstrated at two levels:
|
2016-12-06 16:16:47 +00:00
|
|
|
1. Unit testing the flow uses the [LedgerDSL] and [MockServices]. Please see [IssuerFlowTest]
|
|
|
|
|
The IssuerFlow is one of several reusable flows defined in the finance package.
|
2016-11-18 17:51:12 +00:00
|
|
|
2. Integration testing via RPC and HTTP uses the [Driver] DSL to launch standalone node instances
|
|
|
|
|
|
|
|
|
|
Security
|
|
|
|
|
The RPC API requires a client to pass in user credentials:
|
2017-01-30 18:34:48 +00:00
|
|
|
client.start("bankUser","test")
|
2016-11-18 17:51:12 +00:00
|
|
|
which are validated on the Bank of Corda node against those configured at node startup:
|
2017-01-30 18:34:48 +00:00
|
|
|
User("bankUser", "test", permissions = setOf(startFlowPermission<IssuerFlow.IssuanceRequester>()))
|
2017-04-13 16:41:54 +00:00
|
|
|
startNode(BOC.name, rpcUsers = listOf(user))
|
2016-11-18 17:51:12 +00:00
|
|
|
|
|
|
|
|
Notary
|
|
|
|
|
We are using a [SimpleNotaryService] in this example, but could easily switch to a [ValidatingNotaryService]
|
|
|
|
|
|
2016-12-06 16:16:47 +00:00
|
|
|
## Integration with other Demos and Tools
|
2016-11-18 17:51:12 +00:00
|
|
|
|
2016-12-06 16:16:47 +00:00
|
|
|
The Bank of Corda issuer node concept has been integrated into the Explorer tool (simulation nodes) and Trader Demo.
|
2016-11-18 17:51:12 +00:00
|
|
|
|
|
|
|
|
## Further Reading
|
|
|
|
|
|
|
|
|
|
Tutorials and developer docs for Cordapps and Corda are [here](https://docs.corda.net/).
|
