This CorDapp provides a basic example to create, issue and perform a DvP (Delivery vs Payment) of an Evolvable, NonFungible token in Corda utilizing the Token SDK.
There are three flows that we'll primarily use in this example that you'll be building off of.
- We'll start with running
FiatCurrencyIssueFlow. - We'll then create and issue a house token using
HouseTokenCreateAndIssueFlow. - We'll then initiate the sale of the house through
HouseSaleInitiatorFlow.
For development environment setup, please refer to: Setup Guide.
Open a terminal and go to the project root directory and type: (to deploy the nodes using bootstrapper)
./gradlew clean deployNodes
Then type: (to run the nodes)
./build/nodes/runnodes
When started via the command line, each node will display an interactive shell:
Welcome to the Corda interactive shell.
Useful commands include 'help' to see what is available, and 'bye' to shut down the node.
Tue July 09 11:58:13 GMT 2019>>>
You can use this shell to interact with your node.
First go to the shell of PartyA and issue some USD to Party C. We will need the fiat currency to exchange it for the house token.
start FiatCurrencyIssueFlow currency: USD, amount: 100000000, recipient: PartyC
We can now go to the shell of PartyC and check the amount of USD issued. Since fiat currency is a fungible token we can query the vault for FungibleToken states.
run vaultQuery contractStateType: com.r3.corda.lib.tokens.contracts.states.FungibleToken
Once we have the USD issued to PartyC, we can Create and Issue the HouseToken to PartyB. Goto PartyA's shell to create and issue the house token.
start HouseTokenCreateAndIssueFlow owner: PartyB, valuation: 10000 USD, noOfBedRooms: 2, constructionArea: 1000sqft, additionInfo: NA, address: Mumbai
We can now check the issued house token in PartyB's vault. Since we issued it as a NonFungible token we can query the vault for non-fungible tokens.
run vaultQuery contractStateType: com.r3.corda.lib.tokens.contracts.states.NonFungibleToken
Note that HouseState token is an evolvable token which is a LinearState, thus we can check PartyB's vault to view the EvolvableToken
run vaultQuery contractStateType: HouseState
Note the linearId of the HouseState token from the previous step, we will need it to perform our DvP opearation. Goto PartyB's shell to initiate the token sale.
start HouseSaleInitiatorFlow houseId: <XXXX-XXXX-XXXX-XXXXX>, buyer: PartyC
We could now verify that the non-fungible token has been transferred to PartyC and some 100,000 USD from PartyC's vault has been transferred to PartyB. Run the below commands in PartyB and PartyC's shell to verify the same
// Run on PartyB's shell
run vaultQuery contractStateType: com.r3.corda.lib.tokens.contracts.states.FungibleToken
// Run on PartyC's shell
run vaultQuery contractStateType: com.r3.corda.lib.tokens.contracts.states.NonFungibleToken