This sample shows you how to integrate accounts and tokens. This sample talks about a scenario where typically when the Cricket season starts, BCCI (Board of Control for Cricket) starts selling tickets. As of now there are multiple dealers whom the BCCI issues tickets and further these dealers sell tickets to their client. We are trying to simulate similar functionality maintaining the entire issuance and selling of the tickets on Corda Platform.
Nodes:
- BCCI node: source of ticket creation. All the tickets in the market are created by this node.
- Bank Node: source of money. All the money that is transacted between each individual is issued by this node.
- Dealer1 Node: Dealer Agency 1 and it includes
- agent1 account: who will get ticket from the BCCI and sell to others. (To demonstrate same node account token transaction.)
- buyer1 account: who will get the ticket from agent1 and later sell to buyer3 (To demonstrate cross node account token transaction)
- buyer2 account: who will buy the ticket from buyer3.
- Dealer2 Node: Dealer Agency 2 and it includes
- buyer3 account: who will get the ticket from buyer1 and sell to buyer2
For development environment setup, please refer to: Setup Guide.
Deploy and run the nodes by:
./gradlew clean build deployNodes
./build/nodes/runnodes
Run the below flow in Dealer1's interactive node shell. This will create the agent1, buyer1 and buyer2 accounts on the Dealer1 node and share this account info with BCCI, Bank, and Dealer2 node respectively.
flow start CreateAndShareAccountFlow accountName: agent1, partyToShareAccountInfoToList: [BCCI, Dealer2]
flow start CreateAndShareAccountFlow accountName: buyer1, partyToShareAccountInfoToList: [Bank, Dealer2]
flow start CreateAndShareAccountFlow accountName: buyer2, partyToShareAccountInfoToList: [Bank, Dealer2]
Then let's go to the Dealer2 interactive node shell and create buyer3 account:
flow start CreateAndShareAccountFlow accountName: buyer3, partyToShareAccountInfoToList: [Bank, Dealer1]
Run the below query to confirm if accounts are created on Dealer1 node. Also run the below query on Bank and BCCI's interactive node shell to confirm if account info is shared with these nodes.
run vaultQuery contractStateType : com.r3.corda.lib.accounts.contracts.states.AccountInfo
Run the below command on the Bank's interactive node shell, which will issue 20 USD to buyer1 account.
start IssueCashFlow accountName : buyer1 , currency : USD , amount : 10
start IssueCashFlow accountName : buyer3 , currency : USD , amount : 20
start IssueCashFlow accountName : buyer2 , currency : USD , amount : 50
flow start QuerybyAccount whoAmI: buyer1
You can check balance of buyer1 account at Dealer1's interactive node shell. [Option] You can also run the below command to confirm if 20 USD fungible tokens are stored at Dealer1's node. The current holder field in the output will be an AnonymousParty which specifies an account.
run vaultQuery contractStateType : com.r3.corda.lib.tokens.contracts.states.FungibleToken
Run the below flow on BCCI's node. BCCI node will create base token type for the T20 Ticket for the match MumbaiIndians Vs RajasthanRoyals. The ticket ID returned from this flow will be needed in the next steps.
start CreateT20CricketTicketTokenFlow ticketTeam : MumbaiIndiansVsRajasthanRoyals
You can see your ticket state generated via vault query at the BCCI's node:
run vaultQuery contractStateType : com.t20worldcup.states.T20CricketTicket
Run the below flow on BCCI's node to issue a non-fungible token based off the token type which we created in Step5. You will need to replace the <XXX-XXX-XXXX-XXXXX> with the uuid returned from step 6. This token will be issued by the BCCI node to agent1 account on Dealer1 node.
start IssueNonFungibleTicketFlow tokenId : <XXX-XXX-XXXX-XXXXX>, dealerAccountName : agent1
Switching to the Dealer1's node, you can run the following code to confirm if the token has been issued to the dealer1 account.
flow start QuerybyAccount whoAmI: agent1
You can also look for the actual state that is recorded by:
run vaultQuery contractStateType : com.r3.corda.lib.tokens.contracts.states.NonFungibleToken
Note that, the current holder it will be a key representing the account.
flow start DVPAccountsOnSameNode tokenId: <XXX-XXX-XXXX-XXXXX>, buyerAccountName: buyer1, sellerAccountName: agent1, costOfTicket: 5, currency: USD
This is the DVP flow where the buyer(buyer1 account on Dealer1 node) account will pay cash to seller account(agent1 account on Dealer1 node), and the seller account will transfer the ticket token to the buyer. Again, replace the <XXX-XXX-XXXX-XXXXX> with the uuid generated in step 6.
Now let's continue the flow logic to initiate a ticket sale between buyer1 and buyer3. Go to Dealer2 node and run the following code:
flow start DVPAccountsHostedOnDifferentNodes tokenId: <XXX-XXX-XXXX-XXXXX>, buyerAccountName: buyer3, sellerAccountName: buyer1, costOfTicket: 10, currency: USD
Again, We can check for the current vault status by flow start QuerybyAccount whoAmI: XXXXX
Lastly, we will finish the flow logic by one last transaction between buyer3(from Dealer2 node) and buyer2(from dealer1 node). Go to the Dealer1 node and run:
flow start DVPAccountsHostedOnDifferentNodes tokenId: <XXX-XXX-XXXX-XXXXX>, buyerAccountName: buyer2, sellerAccountName: buyer3, costOfTicket: 25, currency: USD
We can finish the demo with the following query to see how much they each get after the full cycle of sales. At Dealer1 node
flow start QuerybyAccount whoAmI: agent1
flow start QuerybyAccount whoAmI: buyer1
flow start QuerybyAccount whoAmI: buyer2
At Dealer2 node
flow start QuerybyAccount whoAmI: buyer3
Confirm who owns the FungibleToken (cash) and NonFungibleToken (ticket) again by running this on Dealer1's node.
For someone who is looking into how to only transfer tokens from one account to other use below steps.
Run the below flow on the Dealer1 node. This will create the agent1, buyer1 and buyer2 accounts on the Dealer1 node and share this account info with BCCI, Bank, and Dealer2 node respectively.
flow start CreateAndShareAccountFlow accountName: agent1, partyToShareAccountInfoToList: [BCCI, Dealer2]
flow start CreateAndShareAccountFlow accountName: buyer1, partyToShareAccountInfoToList: [Bank, Dealer2]
flow start CreateAndShareAccountFlow accountName: buyer2, partyToShareAccountInfoToList: [Bank, Dealer2]
Then let's go to the Dealer2 node and create buyer3 account:
flow start CreateAndShareAccountFlow accountName: buyer3, partyToShareAccountInfoToList: [Bank, Dealer1]
Run the below query to confirm if accounts are created on Dealer1 node. Also run the below query on Bank and BCCI node to confirm if account info is shared with these nodes.
run vaultQuery contractStateType : com.r3.corda.lib.accounts.contracts.states.AccountInfo
Run the below command on the Bank node, which will issue 77 USD to buyer1 account.
start IssueCashFlow accountName : buyer1 , currency : USD , amount : 77
flow start QuerybyAccount whoAmI: buyer1
You can check balance of buyer1 account at Dealer1's node [Option] You can also run the below command to confirm if 20 USD fungible tokens are stored at Dealer1's node. The current holder field in the output will be an AnonymousParty which specifies an account.
run vaultQuery contractStateType : com.r3.corda.lib.tokens.contracts.states.FungibleToken
start MoveTokensBetweenAccounts buyerAccountName : buyer1, sellerAccountName : buyer3 , currency : USD , costOfTicket : 10
This will move tokens from account buyer1 to account buyer3
flow start QuerybyAccount whoAmI: buyer1
You can check balance of buyer1 account at Dealer1's node
run vaultQuery contractStateType : com.r3.corda.lib.tokens.contracts.states.FungibleToken
flow start QuerybyAccount whoAmI: buyer3
You can check balance of buyer3 account at Dealer2's node
run vaultQuery contractStateType : com.r3.corda.lib.tokens.contracts.states.FungibleToken
For accounts visit https://github.com/corda/accounts.
For tokens visit https://github.com/corda/token-sdk.